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PREFACE 

The System Programmer's Manual is written for programmers, analysts, 
and field engineers who are responsible for installing, debugging, or 
modifying the CRAY Operating System, Version 1. 

This manual contains information to aid the programmer in making the 
transition from the external features of the operating system as described 
in the CRAY-OS Version 1 Reference Manual, CRI publication 2240011 to the 
listings. The reader is assumed to be familiar with the contents of the 
CRAY-OS Reference Manual and to be experienced in coding in the CRAY 
Assembly Language (CAL) as described in the CAL Version 1 Reference Manual, 
CRI publication 2240000. 

Although a general familiarity with the concept of operating systems is 
assumed, this publication does not presume that the reader knows the 
principles or techniques of any other specific operating system. 

This manual is in three parts, as follows: 

VOLUME ONE 

PART 1 SYSTEM COMPONENTS 

This part familiarizes the reader with the structure, major components, 
interfaces, and philosophy of the system. 

VOLUME TWO 

PART 2 SYSTEM GENERATION 

This part describes the Cray Research released software materials and 
how they are used to bring the CRAY-OS Operation System and its product 
set to an operational state. 

PART 3 SYSTEM STARTUP AND RECOVERY 

This part gives the procedure for installing, starting, or recovering 
the operating system. 
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PART 4 SYSTEM MODIFICATION AND MAINTENANCE 

This part gives the rules and conventions to be followed when modifying 
or adding to the system. It also describes system macros, techniques 
for adding features to the system, and tools and techniques for analyz- 
ing and diagnosing problems and failures. 



VOLUME THREE 



PART 5 SYSTEM TABLE DESCRIPTIONS 

This section contains detailed descriptions of tables resident in 
EXEC and STP. 
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SYSTEM TABLE DESCRIPTIONS 



1.1 INTRODUCTION 

The tables summarized in table 1.1-1 are described in subsequent sections 
in alphabetical order according to their unique 2-character prefixes. 
Pages are also numbered according to the table prefixes. Tables may be 
manipulated by use of the table management macros described in part 4, 
section 2. 

Table 1.1-1. Summary of tables 



Prefix 





AC 


1 


AU 




BA 


1 


BG 




CB 




CC 




CH 




CI 




CM 


1 


CS 




DA 




DC 




DD 




DE 




DN 




DP 




DR 




DT 




DV 


1 


EC 




EQ 


1 


IB 



Table name and common mnemonic 

Job Accounting Table (JAC) 
Active User Table (AUT) 
Binary Audit Table (BAT) 
Begin Code Execution Table (BGN) 
Channel Buffer Table (CBT) 
Chain Control 
Channel Table (CHT) 
Chain I tern 

Communication Module (CMOD) 
Class Structure Definition (CSD) 
Dataset Allocation Table (DAT) 
Dataset Catalog (DSC) 
Dataset Definition List (DDL) 
Device Error Table (DET) 
Dataset Name Table (DNT) 
Dataset Parameter Area (DSP) 
Device Reservation Table (DRT) 
Device Channel Table (DCT) 
Device Label (DVL) 
Error Code Table (ECT) 
Equipment Table (EQT) 
Interactive Buffer Table (IBT) 



Residence 

User 

STP 

User 

User 

EXEC 

STP 

EXEC 

STP 

STP 

STP 

STP 

Disk 

User 

STP 

JTA/STP 

User/STP/JTA 

STP 

STP 

Disk 

STP 

STP 

STP 
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Table 1.1-1 (continued) Summary of tables 

Prefix Table name and common mnemonic Residence 

JC Job Communication Block (JCB) User 

JT Job Table Area (JTA) Below user 

JX Job Execution Table (JXT) STP 

LC Link Configuration Table (LCT) STP 

LF Logical File Table (LFT) User 

LG Log Tables (LGI ,LGR,LGUQ) STP 

LS Link Interface Stream Table (LST) STP 

LT Link Interface Table (LIT) STP 

LX Link Interface Extension Table (LXT) STP 

MP Memory Pool Table STP 

MS Memory Segment Table (MST) STP 

OD Open Dataset Name Table (ODN) User 

PD Permanent Dataset Table (PDS) STP 

PI Permanent Dataset Information (PDl) STP 

PM Permanent Dataset Definition (PDD) User 

PR Procedure File Stack Table JTA 

PT Pool Table STP 

PU Physical Unit Table (PUT) EXEC 

QD Queued Dataset Table (QDT) STP 

RJ Rolled Job Index Table (RJl) STP 

R0_ Request Table (RQ.T) STP 

SD System Dataset Table (SDT) STP 

ST System Task Table (STT) EXEC 

TB Task Breakpoint Table (TBPT) EXEC 
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l.AC JOB ACCOUNTING TABLE - JAC 

The Job Accounting Table, illustrated in figure l.AC-1, defines the format 
of data returned to the user by the F$ACT call. 










56 63 







JN 


'///////, 


1 


TSX 


2 


TSW 


3 


TSD 


4 


*0B 


5 


IOR 


6 


USR 


7 




USR1 


'////////, 


8 


XHI 


9 




DM I 




10 


TID 


11 
12 
13 
14 


|jjj 


■Hi 


(fli 


15 


SIT1 


16 


SIT2 


17 




SIT3 




18 


SIT4 


19 


SIT5 



Figure l.AC-1 Job Accounting Table (JAC) 
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Field 



Word 



Bits 



ACJN 





0-55 


ACTSX 


1 


0-63 


ACTSW 


2 


0-63 


ACTSD 


3 


0-63 


AC I OB 


4 


0-63 


ACIOR 


5 


0-63 


ACUSR 


6 


0-63 


ACUSR1 


7 


0-55 


ACXMI 


8 


0-63 


ACDMI 


9 


0-63 


ACTID 


10 


0-63 




11-14 


0-63 


ACSIT1- 






ACSIT5 


15-19 


0-63 



Description 

Jobname 

CPU time in cycles 

Wait time for CPU 

I/O wait time 

Disk blocks moved 

User I/O request 

Characters 1-8 of user number 

Characters 9-15 of user number 

Memory integral for execution time 

Memory integral for I/O wait time 

Terminal ID 

Reserved 

Reserved for site use 
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l.AU ACTIVE USER TABLE - AUT 

The Active User Table is an STP-resident table used during interactive 
communication. An entry is made in the AUT when the user logs on. The 
entry is released when user processing is finished and the user logs off. 



Header: 







TN 




Table: 

OFF CSP CCF LSF 





1 

2 

3 

4 

5 

6 

7 

8 

9 



WiMr 



24 



SDT 



32 36 40 



ST 



USER 




SID 



RPN 



PASS 



TLIM 



NXST 



RMN 



RST REC 



WC MT SMJ 

R H T 1 ^W^///////M 

Wm RCHN 



48 52 



PN 



ICT 



OMQH 



IMQH 



SMID 



RWC 



Figure l.AU-1. Active User Table (AUT) 



Field 



Word 



AUTN 





AUNE 





AUOFF 





AUBYE 





AUCSP 





AUABT 





AUCCF 





AUIMR 
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Bits 




Description 


0-24 




Table name 


48-63 




Number of active entries 







Logged off terminal flag 


1 




Job terminated while logged off 


2 




CSP loaded 


3 




Abort flag 


4 




Concentrator relogged flag 


5 




Message received flag 




Part 
l.AU- 


5 
1 



D-02 



Field 



Word 



Bits 



AULSF 





6-7 


AUERC 





8-15 


AUSDT 





16-39 


AUST 





40-47 


AUPN 





48-63 


AUUSER 


1 


0-63 


AUTID 


2 


0-63 


AUMN 


3 


0-3 


AUMML 


3 


8-19 


AUOSUP 


3 


20 


AUISUP 


3 


21 


AUSF 


3 


22-25 


AUICT 


3 


40-63 


AUOQC 


4 


0-63 


AUNOM 


4 


0-15 


AUOMQT 


4 


32-47 


AUOMQH 


4 


48-63 


AUIQC 


5 


0-63 


AUNIM 


5 


0-15 


AUIMQT 


5 


32-47 


AUIMQH 


5 


48-63 


AUPASS 


6 


0-63 


AUTLIM 


7 


0-63 


AUSID 


8 


0-15 


AUNXST 


8 


16-19 



Description 

Logoff special function field 

Error code 

SDT for job 

Terminal status 

Process number 

User name 

Terminal ID 

Message number 

Maximum message length 

Output suspended flag (cleared by SCP) 

Input suspended flag (cleared by SCP) 

Special function field 

Interactive console entry pointer 

Output Q control word 

Number of output messages 

Output message queue tail 

Output message queue head 
Input Q control word 

Number of input messages 

Input message queue tail 

Input message queue head 
Password 

Time of last input message 
Front end ID 
Next state 
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Field 



Word 



AUWC 


8 


AUMT 


8 


AUSMID 


8 


AURMES 


9 


AURPN 


9 


AURMN 


9 


AURST 


9 


AUREC 


9 


AURMT 


9 


AURSF 


9 


AURMOD 


9 


AURCHN 


9 


AURWC 


9 



Bits 

20-31 

32-39 

40-63 

0-63 

0-11 

12-15 

16-19 

20-23 

24-31 

32-35 

36 

37 

52-63 



Description 
Word count 
Sent message type 
Sent message ID 
Received message 



Recei 
Recei 
Recei 



Recei 



ved process number 
ved message number 
ved status 



Received error code 



ved message type 



Received special function 
Received mode 
Received chain flag 
Received word count 
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l.BA BINARY AUDIT TABLE - BAT 

When the binary output parameter is specified on the AUDIT control state- 
ment, the Permanent Dataset Manager creates a 36-word BAT record for each 
permanent dataset meeting control statement requirements and having a 
user number that matches the user number for the job. 








63 





PDN1 


1 


PDN2 


2 


ED 




3 


ID 


4 


SZ 




5 


RT 


6 


ACC 


7 


CRT 


8 


CRD 




9 


CRH 


10 


TDM 


11 


TDD 




12 


TDH 


13 


ACT 


14 


ACD 


15 


ACH 


16 


LDV 


17 


MFT 


18 


MFD 


19 


MFH 


20 
35 


''fKiMMSM/, 


Wm//, 



Figure l.BA-1. Binary Audit Table (BAT) 
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Field 



Word 



Bits 



Description 



BAPDN1 

BAPDN2 

BAED 

BAID 
BASZ 

BART 



0-63 

0-55 

0-63 

0-63 
0-63 

0-63 



BAACC 


6 


0-63 


BACRT 


7 


0-63 


BACRD 


8 


0-63 


BACRH 


9 


0-63 


BATDM 


10 


0-63 


BATDD 


11 


0-63 


BATDH 


12 


0-63 


BAACT 


13 


0-63 


BAACD 


14 


0-63 


BAACH 


15 


0-63 


BALDV 


16 


0-63 


BAMFT 


17 


0-63 


BAMFD 


18 


0-63 


BAMFH 


19 


0-63 




20-35 


0-63 



Permanent Dataset Name; characters 1-8 
left justified with blank fill 

Permanent Dataset Name; characters 9-15 
left justified with blank fill 

Edition number; 1-4095 represented in 
binary 

User ID, left justified with blank fill 

Dataset size (in words) represented in 
binary 

Retention period; 1-4095 represented in 
b i n ary 

Number of accesses represented in binary 

Creation time in cycles 

Creation date as mm/dd/yy 

Creation time as hh:mm:ss 

Time of last dump in cycles 

Date of last dump as mm/dd/yy 

Time of last dump as hh:mm:ss 

Time of last access in cycles 

Date of last access as mm/dd/yy 

Time of last access as hh:mm:ss 

Logical device name 

Time of last modification in cycles 

Date of last modification as mm/dd/yy 

Time of last modification as hh:mm:ss 

Reserved 
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l.BG BEGIN CODE EXECUT I ON TABLE -BGN 

The BGN table specifies necessary parameters to begin the execution of 
code that has been loaded into the user area by CSP. 



PSF 




Figure l.BG-1. Begin Code Execution Table (BGN) 



Field 



Word 



Bits 



BGPSF 








BGPRGL 





16-39 


BGPRWC 





40-63 


BGPSV 


1 


0-63 


BGBP 


2 





BGENT 


2 


40-63 



Description 

Preset value flag 

Total program length including blank 
common 

Program word count 

Preset value, ignored if PSF=0, else 
value with which to fill program's 
blank common area 

Breakpoint flag 

Program entry point address 
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l.BP BUFFER POOL TABLE - BPT 

The Buffer Pool Table is resident in the high range of memory and is used 

for buffer pool management in connection with interactive communication. 



-2 



16 



32 



48 



TXT 



SZ 



OFF 



LBID 



Figure l.BP-1. Buffer Pool Table (BPT) 



FBID 



Field 



Word 



Bits 



BPTXT 


-2 


0-63 


BPSZ 


-1 


0-15 


BPOFF 


-1 


16-31 


BPLBID 


-1 


32-47 


BPFBID 


-1 


48-63 



Description 

Beginning of text 

Message size 

Offset to unmoved portion of message 

Buffer ID for continuation of message 

Next message buffer ID 
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l.CB CHANNEL BUFFER TABLE - CBT 

This EXEC-resident table is used for working storage by the disk driver. 
There is one entry for each disk channel. The three forms of the CBT 
entries are illustrated in figures l.CB-1 through l.CB-3. 



0123 



28 32 38 if 



U8 52 58 63 




Figure l.CB-1. Disk I/O form of Channel Buffer Table (CBT) 




1 
2 
3 
4 
5 
6 
7 




v///////)/////////////////mwA 



Figure l.CB-2. Normal and error pseudo channel form of Channel Buffer Table 
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1 

2 
3 
4 
5 
6 
7 








2k 


"♦0 63 


JST 


JLT 


TSX 


TLTU 


■ 


w///////m//imwMWA 


WWMWMMM 


TPB 


SR 


w////////////////////////////////////////////////////////////////^ 



Field 

CBBO 
CBJST 

CBDNT 
CBPUT 
CBJLT 
CBMEM 
CBTSX 

CBDCT 
CBISZ 
CBTLTU 

CBICH 

CBUT 

CBCYL 

CBTK 

CBSC 

CBCNT 

CBTPB 
CBEQT 
CBSR 
CBTD 



1. Rea 


1-time pseudo 


Word 


Bits 





40-63 





0-63 


1 


16-39 


1 


40-63 


1 


0-63 


2 


40-63 


2 


0-63 


3 


40-63 


3 


48-63 


3 


0-63 


4 


32-37 


4 


38-39 


4 


40-51 


4 


52-57 


4 


58-63 


5 


48-63 


6 


24-39 


6 


40-63 


6 


40-63 


7 






channel form of Channel Buffer Table (CBT) 
Description 

Subroutine return address; first form only 

Job starting time in cycles; third form 
only 

DNT address; first form only 

Active physical unit table; first form 

Job time limit in cycles; third form only 

Current transfer address; first form only 

User execution time at start of interval; 
third form only 

DCT address relative to EXEC; first form 

Buffer increment size; first form 

Time of last total time update; third 
form only 

Input channel number 

Unit number 

Cylinder 

Track 

Sector 

Sector count 

Task parameter block address 

Equipment Table address relative to EXEC 

Status register 

Transfer direction; first form only. 
1 = write. 
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Field Word Bits Description 

Normal pseudo channel; second form only 

Retry flag; first form only 
Error pseudo channel; second form only 
Clear margin flag; first form only 
DSP address 



CBN 


7 





CBTRY 


7 


1 


CBE 


7 


1 


CBMGN 


7 


2 


CBDSP 


7 


16-39 
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l.CC CHAIN CONTROL - CC 

Intertask communication requires chain control words in the format defined 
in figure l.CC-1. 

8 16 hO 6 3 

TL_orQl-[ 







TM or QM 



HEAD 



TAIL 



Figure l.CC-1. Chain Control Word 



Field 
CCTM 

CCQM 

CCTL 
CCQL 

CCHEAD 
CCTAIL 



Word 











Bits Description 

0-7 Maximum number of items to be queued to a 

particular task 
0-7 Maximum number of items to be queued from 

one task to another 
8-15 Number of items queued to a particular task 
8-15 Number of items to be queued from one task 

to another 
16-39 Address of first item on the chain 
40-63 Address of last item on the chain 
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l.CH CHANNEL TABLE - CHT 

The Channel Table resides in EXEC memory and contains information for use 
by the interrupt handlers. There is one entry for each channel, physical 
or pseudo. Refer to figure l.CH-1. 







16 



21+ 



i+O 



63 



TN 


^mm^m^m^^ 


• 
• 
• 


TPB 


CTA 


I HA 


• 
• 
• 



J Header 



Entry 



Figure l.CH-1. Channel Table (CHT) 



HEADER 






Field 


Word 


Bits 


CHTN 





0-23 


ENTRY 






Field 


Word 


Bits 


CHTPB 





0-15 


CHCTA 





16-39 


CHIHA 





40-63 



Description 

Table name; "CHT" in ASCII 



Description 

Address of task parameter word 
Control table address 
Interrupt handler address 
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l.CI CHAIN ITEM - CI 

Any item queued using the STP common routines CHAIN and UNCHAIN must 
reserve the first two words of the item to be used by the common routines 
as shown in figure l.CI-1. 




1*0 



^^3 



Figure l.CT-1 Chain Item 



BL 



CC 



63 



Field 
CIEX 

CIFL 

CIBL 

CICC 



Word 






1 



Bits Description 

This bit, if set, indicates that the 
item is in execution. 

16-39 Forward link; address of next item on 
the chain 

40-63 Backward link; address of the preceding 
item on the chain 

40-63 Address of the chain control word for 
this item 
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63 



: SO-ifi!-'- : V# : 



IN0 



INI 



OUT0 



OUT1 



Figure l.CM-1 Communication Module (CMOD) 



Field 


Word 


Bits 


Description 




0,1 


0-63 


Reserved for chain control 


CMIN0 


2 


0-63 


INPUT + 


CMIN1 


3 


0-63 


INPUT + 1 


CMOUT0 


4 


0-63 


OUTPUT + 


CM0UT1 


5 


0-63 


OUTPUT + 1 
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l.CS CLASS STRUCTURE DEFINITION - CSD 

The Job class structure definition is contained in the CSD. 

The CSD header, which contains general information about the structure, 
precedes the class maps. One CSD class map exists for each class defined in 
the structure. Class maps appear in descending rank order. 

The variable length characteristic expressions follow the class maps, and 
each class contains a pointer to its expression. The CSD class expressions 
are variable length. 

Header: 









15 


31 
DT 




48 


56 







S 


1 


SNM A0.F 


y /////////, 


2 


W///////////M 


SCUM 


\ 


SLI 


NCL 


3 


M^^M^^^ 


APL 


NCW 



F 


igure 1 


.CS-1. Cli 


Field 


Word 


Bits 


CSSDT 





0-63 


CSSNM 


1 


0-55 


CSSCUM 


2 


15-30 


CSAOF 


2 


31 


CSSLI 


2 


32-47 


CSNCL 


2 


48-63 


CSAPL 


3 


32-47 


CSNCW 


3 


48-63 


Class map: 







Class Structure Definition (CSD) header 



Description 

Date/time of last rollout 

Class structure name 

Structure cumulative JXTs reserved 

If 1, all classes off 

LIMIT default 

Number of classes defined in structure 

Number of pool JXTs allocated 

Number of classes waiting for JXTs 








8 


16 




24 


32 


40 


49 


56 63 





CNM 


y/////////, 


1 


P 


RES 


RCUM 




COF 




2 


MAX 


ACT 


*L- 


WTG 




wyyyyyyZ'. 



OFF 
Figure l.CS-2. CSD map 
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Field 


Word 


Bits 


CSCNM 





0-55 


CSP 


1 


0-7 


CSRES 


1 


8-23 


CSRCUM 


1 


24-39 


CSCOF 


1 


40-63 


CSMAX 


2 


0-15 


CSACT 


2 


16-31 



CSOFF 2 32 

CSWTG 2 33-48 
Class expressions: 




1 

ESCEXLT+1 



Description 

Class name 

Class assigned priority shifted left four 
bits; ignored if CSP=377g 

JXTs reserved by class 

JXTs reserved by class of a higher rank 

Class offset 

Class maximum 

Actual number of JXTs allocated to this 
class 

If 1, the class is off; if 0, the class is 
on 

Number of jobs waiting for JXTs 






24 




40 63 


CEXL 




EXL 


wmmmmm, 






EXP 




EXP 

. . ,. ,. 



Figure l.CS-3. CSD expressions 



Field 



Word 



Bits 



CSCEXL 





0-23 


CSEXL 





24-49 


CSEXP 


1 to 
CSCEXL+1 


0-63 


Last word 


: 





Descriptions 

Length, in words, of cracked expression 
Length, in words, of printable expression 
Cracked class expression 



I(3CSDMAX-1 



63 



SLW 



Figure l.CS-4. CSD last word 



Field 



Word 



CSSLW I0CSDMAX-1 



Bits Description 

0-63 Date/time of last rollout 
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l.DA DATASET ALLOCATION TABLE - DAT 

A DAT exists for each active dataset in the system. A DAT defines where 
a dataset logically resides on mass storage, i.e., on which logical 
devices and what portions of each device. 

The DAT header contains general dataset information. 

The DAT partition header contains general information concerning a 
particular partition of the DAT. A partition represents a portion of a 
dataset resident on a single logical device. If the dataset is a 
permanent dataset, the DAT may be used by multiple users. 

Each allocation index in a partition is a bit number in the respective 
Device Reservation Table (DRT). 

The DAT is composed of as many 16-word DAT pages as necessary to 
represent the mass storage occupied by the dataset. Word of a page 
contains a 24-bit address of the continuation of the DAT if more pages 
are necessary. Additional DAT pages continue from the point at which the 
last DAT left off. 

Figure l.DA-1 illustrates the DAT. 



DAT SPACE HEADER 
Field Word 



DATN 





DAWCT 





DAPA 





DAMAP 


1 


DAT PAGE 


HEADER 


Field 


Word 


DAPN 





DAJORD 






Bits Description 

0-23 DAT table name 

24-39 DAT space map length in words 

40-63 Number of DAT pages available 

0-63 Beginning of DAT page map 



Bits Description 

0-7 Page number 

32-39 JXT ordinal; set to zero if the DAT is 
in STP, set to the JXT ordinal if the 
DAT is in the JTA. 
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DAT 
Page 










16 


Zh 


28 


32 




kO 


1+8 


63 





TN 


WCT 


PA ) 


1 


MAP ( 




• 
• 
• 





PN 


^%m^^^ 


JORD 


DAT 


1 


DSC 


AS 




PDS 




2 


CA 


'//////A 


DSZ 


3 






LDV 






' 


4 


y/////////////A 


BPB 


NPA 


NAI 




5 


AI 


AI 


AI 


AI 


6 


A I 


AI 


AI 


AI 




7 


AI 


AI 


AI 


AI 


8 


LDV ] 


9 


W//////////A 


BPB 


NPA 


NAI / 


10 


AI 


AI 


AI 


AI 




11 


AI 


AI 


AI 


AI 


12 


AI 


AI 


AI 


AI 


13 


AI 


AI 


AI 


AI 


14 


AI 


AI 


AI 


AI 


15 


AI 


AI 


AI 


AI 





PN 


V///////////////////A 


JORD 




DAT 




1 


AI 


AI 




AI 


AI 




• 
• 
• 


15 


AI 


AI 


AI 


AI 


' 



DAT 

Space 

Header 



DAT Page 
Header 

DAT Entry 
Header 

DAT Parti ti 
Header 



DAT 
' Partition 



DAT Parti ti 
Header 



VDAT Parti ti 



DAT Page 
Header 



Figure l.DA-1. Dataset Allocation Table (DAT) 
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DADAT 



40-63 Next page address; set to zero if no 

continuation page exists. If the field 
is greater than zero, the DAT resides 
in STP and the field contains the STP 
relative DAT address. If the field is 
less than zero, then the DAT resides in 
the JTA and the DAT address is equal to 
the JTA address minus the value of the 
field DADAT. 



DAT ENTRY 


HEADER 


Field 


Word 


DADSC 


1 


DAAS 


1 


DAPDS 


1 


DACA 


2 


DADSZ 


2 



Bits Description 

0-27 DSC pointer (only if permanent dataset) 

28-39 Allocation style (contiguous All's per AI) 

40-63 Permanent dataset table entry address 
(only if permanent dataset) 

0-23 Pointer to parcel for next AI 

32-63 Dataset size in words 



DAT PARTITION HEADER 



Field 


Word 


Bits 


Description 


DALDV 





0-63 


Logical device name 


DABPB 


1 


16-31 


Blocks per bit 


DANPA 


1 


32-47 


Next partition address (rel 
address) 


DANA I 


1 


48-63 


Number of AI's in partition 


DAAI 


n 


0-15 
16-31 
32-47 
48-63 


Allocation index 



2240012 



Part 5 
l.DA-3 



D-01 



l.DC DATASET CATALOG - DSC 

The DSC is a disk-resident table. It is divided into 512-word pages with 

each page consisting of a block control word, a 7-word header and eight 

63-word entries. 

There are two types of pages, hash pages and overflow pages. The PDN is 

hashed to determine the hash page number to be put into the DSC entry. If 

that has page is full, the entry is placed in the sequential overflow page 

area. 



_fi_3 



511 



Block Control Word 



Header 



DSC 
Entries 



Figure l.DC-1. Dataset Catalog (DSC) page 
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DSC PAGE HEADER 

Each DSC page has a header as shown in figure l.DC-2. 



12 




Figure l.DC-2. DSC Page Header 



Field 



Word 



Bits 



DCOV 


1 





DCPF 


1 


1 


DCPN 


1 


48-63 


DCNE 


2 


56-63 



Description 

Page overflow has occurred 

Page is currently full 

Page number 

Number of entries in use on this page 
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DSC ENTRY 

A DSC for a permanent dataset may occupy as many DSC entries as necessary to 
contain the DAT for the dataset. Subsequent DSC entries for the same 
permanent dataset contain only continuations of the DAT. 



Field 
DCC 

DCDWN 
DCCRS 



DCERR 



DC I DA 



DCIQI 



Word 






Bits 


1 



DCS 





61 


DSO 





62 


DCI 





63 


DCDN 


1 


0-55 


DCPDN 


2 
3 


0-63 
0-55 


DCPDN1 


2 


0-63 


DCPDN2 


3 


0-55 


DCRDP 


4 


0-63 



DCWTP 



0-63 



Description 

Continuation flag (set if this is a 
continuation entry 

Down flag. Set if DAT contains at least 
one reference to a device whose EQT entry 
declares the device unavailable (EQNA=1) 

Cross-allocated flag. Set if DAT contains 
at least one reference to an AI on any 
device which is either (1) flawed, or (2) 
mentioned in the DAT for some other 
permanent dataset, the Dataset Catalog, or 
the reserved system dump area. 

Catastrophic error flag. Set if Startup is 
unable to recover the dataset due to errors 
in the DSC entry and the installation or 
operator selected option was RETAIN. 

Inconsistent disk allocation. Set by 
Startup if one or more DSC entries with the 
same Queued Dataset Table (QDT) index do 
not agree in disk reservation, and if 
I@DSCERR is RETAIN. 

Invalid Queued Dataset Table (QDT) index. 
Set during Dataset Catalog recovery if the 
QDT table is smaller than the QDT index. 
It is cleared when the QDT table becomes 
large enough to handle all entries. 

Saved flag (set if SAVE entry) 

Output flag (set if output dataset) 

Input flag (set if input dataset) 

Dataset name (spooled datasets only) 

Permanent dataset name; 
1-15 characters 

Permanent dataset name; characters 1-8 

Permanent dataset name; characters 9-15 

Read permission control word (saved 
datasets) 

Write permission control word (saved 
datasets) 
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DWN- 



01 CRS s 




RDP 



WTP 



11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 

23 

24 
25 

26 
27 



31 
32 

47 
61 

62 



MNP 




NRR^-WAIT 






USR 



•I A OJSQ 



|TXU 



FM 



RT 



ED 



y INIT 



OJB 



SID 



DID 



DC 



JSQ 



TID 



SF 



ACS 



FL 



TL 



PR 



CRT 



ACT 



TDM 



MFT 



afr 



3 1 jsp 



JCN 



YS 



JCR 



CL 



OLM 



RJST 




DNS 



DAT 



DAT 



FPE 



DSC continuation 
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Figure l.DC-3. Dataset Catalog (DSC) Table entry 
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Field 
DCMNP 



DCQDT 



DCID 


12 


0-63 


DCUSR 


13 


0-63 




14 


0-55 


DCUSR1 


13 


0-63 


DCUSR2 


14 


0-55 


DCNRR 


15 






DCINIT 



15 



DCJSQ 


17 


DCTID 


18 


DCSF 


19 


DCACS 


20 


DCFL 


20 


DCTL 


20 


DCPR 


20 



Word Bits Description 
6 0-63 Maintenance permission control word (saved 

datasets) 

11 55-63 Multi-type flag/QDT entry index (saved end 

spooled) 

User ID (saved dataset) 

User number, 1-15 characters 

User number, characters 1-8 

User number, characters 9-15 

Job rerun flag. Set if job cannot be 
rerun. 

Job initiation flag. Set if job has been 
initiated. 

WAIT flag for disposed dataset 

Interactive spool flag 

Originating job sequence number 

Text length in blocks (a block is equal to 
one DSC DAT page) 

Format designator (output datasets) 

Retention period (0-4095 days) 

Edition number (1-4095) (saved datasets) 

Originiating job name (spooled datasets) 

Source ID (2 characters) 

Destination ID (2 characters) 

Disposition code 

DCIN=IN Job dataset 

DCST=ST Staged permanent dataset 

DCPR=PR Print dataset 

DCPT=PT Plot dataset 

DCPU=PU Punch dataset 

DCMT=MT Magnetic tape dataset 

48-63 Job sequence number 

0-63 Terminal ID 

0-63 Special forms 

0-15 Number of accesses (saved datasets) 

16-31 Field length/512 (input datasets) 

32-55 Time limit (input datasets) 

56-63 Priority (input datasets) 



DCWAIT 


15 


2 


DCIA 


15 


3 


DCOJSQ 


15 


5-20 


DCTXL 


15 


21-23 


DCFM 


15 


24-39 


DCRT 


15 


40-51 


DCED 


15 


52-63 


DCOJB 


16 


0-63 


DCS ID 


17 


0-15 


DCDID 


17 


16-31 


DCDC 


17 


32-47 
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Field 



Word 



Bits 



DCCRT 


20 


0-63 


DCACT 


22 


0-63 


DCTDM 


23 


0-63 


DCMFT 


24 


0-63 


DCJCN 


25 


0-55 


DCCL 


26 


0-55 


DCSYS 


27 


1 


DCJSP 


27 


2-9 


DCJCR 


27 


10-25 


DCOLM 


27 


26-49 


DCRJST 


27 


50-55 


DCDNS 


31 


0-63 


DCDAT 


32-46 


0-63 




47-61 


0-63 


DCFPE 


62 


8-35 


DCFPP 


62 


8-31 


DCFEN 


62 


32-35 


DCDSC 


62 


36-63 


DCDCP 


62 


36-59 


DCDCE 


62 


60-63 



Description 

Creation time (cycles) 

Time of last access (cycles) 

Time of last dump (cycles) 

Time of last modification (cycles) 

Job class name 

CL parameter from JOB statement 

System job, if set 

P parameter from JOB statement 

Job class rank 

OLM parameter from JOB statement 

Job status flag 

Reserved for installation 

A 15-word DAT page or optional text 
A 15-word DAT page 

First DSC page/entry for the dataset 

Page number of first DSC entry 

Entry number of first DSC for the 
dataset 

Next DSC entry for continuation: 

Page number of DSC continuation 

Entry number of DSC continuation 



2240012 



Part 5 
l.DC-6 



D-02 



l.DD DATASET DEFINITION LIST - DDL 

A Dataset Definition List in the user field must accompany any create 

DNT (F$DNT) request. 



012 



40 



1+8 




56 63 



sz 



RFZ 



DC 



LM 



Figure l.DD-1. Dataset Definition List (DDL) 



I 



Field 

DDDN 

DDLDV 

DDRDM 



DDUDS 



DDNFE 



Word 


1 
2 



Bits 

0-55 
0-63 




DDSTAT 


2 


3 


DDMR 


2 


4 


DDIA 


2 


5 


DDTRAN 


2 


6 


DDBFI 


2 


7-15 



DDSZ 
DDBFZ 



2 
3 



40-63 
49-63 



Description 

Dataset name 
Logical device name 
Random dataset flag 

Sequential 

1 Random 

Undefined dataset structure 

COS blocked dataset structure 

1 Undefined structure 

Return error if dataset does not exist. 
(S0) returned nonzero if DNT does not 
exist; no DNT is created. 

Request dataset statistics 

Dataset is to be memory resident 

Interactive type dataset 

Transparent mode for interactive dataset 

Blank field indicator for character 1/0 

O'000 BFI=I@BFI 

<O'400 BFI=user specified ASCII character 

=O'400 BFI=000 

>O'4j30 Blank compression disabled 

Dataset size in 512-word blocks 

Buffer size in 512-word blocks 
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Field 

DDBSZ 
DDDC 



Word 

3 

4 



DDLM 



Bits Description 

49-63 Alternate name for DDBFZ to match $SYSTXT r 
48-63 Disposition code 

DCIN=IN Job dataset 

DCST=ST Staged permanent dataset 

DCSC=SC Scratch dataset 

DCPR=PR Print dataset 

DCPT=PT Plot dataset 

DCPU=PU Punch dataset 

DCMT=MT Magnetic tape dataset 
40-63 Dataset size limit in 512-word blocks 
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l.DE DEVICE ERROR TABLE - PET 

This STP-resident table is used for building messages for the system log, 










56 63 





JN 


V//////A 


1 


DEV 


2 


DN 


W//A 


3 


CP 


4 


IR 


5 


STS 


6 


ASTS 



Figure l.DE-1. Disk Error Table (DET) 



Field 



Word 



Bits 



DEJN 





0-55 


DEDEV 


1 


0-63 


DEDN 


2 


0-55 


DECP 


3 


0-63 


DEIR 


4 


0-63 


DESTS 


5 


0-63 


DEASTS 


6 


0-63 



Description 

Jobname 

Logical device name 

Dataset name 

Device current physical position 

Device initial logical request 

Equipment status 

Auxiliary status 



2240012 



Part 5 
l.DE-1 



D-02 



l.DN DATASET NAME TABLE - DNT 

The DNT in the Job Table Area (JTA) contains an entry for each dataset of 
a given job. W0JTDNT is the beginning DNT entry address. Figure l.DN-1 
illustrates a DNT entry. 



MPST' 






8 12 


16 22 27 32 


40 49 56 


63 


^2~f 


V///////////M 


MPID + 


MPSIZE + 


-A>///////////////A 


JTDBL+ 


JTDFL + 




MPST" 



MPIDt 



MPSIZEt 



Figure l.DN-1. Dataset Name Table (DNT) entry 



Field 



Word 



MPST 



MPID' 



t 



MPSIZE 
JTDBL + 
JTDFL 1 " 



t 



-2 

-2 
-1 
-1 



Bits Description 

Status of memory area 

Available 

1 In use 

16-39 Memory pool identification 

07070707 JTA dynamic memory 
40-63 Size of the memory area 
16-39 DNT backward link 
40-63 DNT forward link 



Fields that exist only when the DNT is in the dynamic area of the JTA. 
They are used for dynamic memory allocation and DNT linkage. 
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Field 



Word 



Bits 



DNDN 





0-55 


DNAIO 


1 





DNOC 


1 


1-2 



DNP 



DNRDM 



DNUDS 



DNIN 


1 


6 


DNSTAT 


1 


7 


DNMEM 


1 


8 


DNIA 


1 


9 


DNTRAN 


1 


10 


DNPRW 


1 


15 



DNDC 



DNJORD 



16-31 



32-39 



Description 

Dataset name 

Active I/O, set if outstanding 
Open/clost status 

00 Closed 

10 Open for input 

01 Open for output 

11 Open for I/O 

Type of processing; used by Disk Queue 
Manager 

Read 

1 Wr i te 

Random dataset flag 

Sequential 

1 Random 

Dataset structure 

COS blocked dataset 

1 Unblocked structure 

Subdataset: used for $IN 

User requests statistics 

Dataset is memory resident 

Interactive type dataset 

Transparent mode for interactive dataset 

Previous operation read/write: 

Previous operation read 

1 Previous operation write 

Disposition code (two characters) 

DCIN=IN Job dataset 
DCST=ST Dataset to be staged and made 
permanent 

DCSC=SC Scratch dataset 

DCPR=PR Print dataset 

DCPU=PU Punch dataset 

DCPT=PT Plot dataset 

DCMT=MT Magnetic tape dataset 

JXT ordinal if the DNT is in the job's JTA: 
zero if the DNT resides in STP. 
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Field 



DNDAT 



Word 



Bits 
40-63 



DNNBK 



0-15 



DNSBK 


2 


16-39 


DNBUF 


2 


40-63 


DNPDS 


3 





DNACS 


T 


1-11 


DNMNP 


3 


9 


DNWTP 


3 


10 


DNRDP 


3 


11 


DNDTM 


3 


13-18 


DNBFI 


3 


19-27 



DNAS 


3 


32-39 


DNSZ 


3 


40-63 


DNRCL 


4 





DNRLS 


4 


1 


DNTIO 


4 


2 


DNJTF 


4 


3 


DNIOU 


4 


4 


DNEND 


4 


5 


DNBIO 


4 


6 



Description 

Dataset allocation table address 

No DAT assigned 

DAT in STP 

DAT in job's JTA 

Number of blocks to be read or written; 
number of words in last block to be 
written if (DNEND)=1 

Starting block number 

I/O buffer address 

Permanent dataset flag 

Dataset access flags 

Maintenance permission flag 

Write permission flag 

Read permission flag 

Index to Task I/O save area 

Blank field indicator for character I/O 

O'000 BFI=I@BFI 

O'400 BFI=user specified ASCII 

O'400 BFI=000 

O'400 Blank compression disabled 

Allocation style (tracks per AI) 

Dataset size (in 512-word blocks) 

Recall flag from DSP 

Release flag 

Task I/O recall flag; (DNCIO=recall ) 

address 

JTA dataset flag; if (DNJTF)=1, buffer is 
in the JTA 

User I/O flag; 1 indicates the DSP or 
buffer for the current I/O request are in 
the job field (below user HLM). 

Write short or zero-length block flag 

Buffered I/O request flag 
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Held Word Bits Description 

Job in recall for this request 

Dispose flag 

Memory recall flag; 1 if waiting for JTA 
memory expansion. 

Deferred disposition flag 

Return address for task I/O 

DSP address 

Logical device name 

I/O requests issued to DQM 

Blocks transferred 

Dataset buffer size in 512-word blocks 

Partial block size in words 

Multitype flag/QDT entry index 

Number of last block written 

Dataset catalog size in words 

Dataset size limit in 512-word blocks 

JTA relative address of the PDD for a 
deferred disposition 

10 Status of memory pool area 

Available 

1 In use 

10 16-39 Memory pool identification 

07070707 JTA dynamic memory 
10 40-63 Size of memory pool area 



DNJIO 


4 


7 


DNDPS 


4 


8 


DNMRCL 


4 


9 


DNDFR 


4 


10 


DNCIO 


4 


16-39 


DNDSP 


4 


40-63 


DNLDV 


5 


0-63 


DNIOR 


6 


0-21 


DNIOB 


6 


22-48 


DNBFZ 


6 


49-63 


DNPBS 


7 


0-8 


DNQDT 


7 


31-39 


DNLBN 


7 


40-63 


DNDCZ 


8 


8-39 


DNLM 


8 


40-63 


DNPDD 


9 


40-63 



MPST§ 

MPID§ 
MPSIZE§ 



Fields that exist only when the DNT is in the dynamic area of the JTA. 
They are used for dynamic memory allocation and DNT linkage. 
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l.DP DATASET PARAMETER AREA - DSP 



Logical I/O requires the presence of a DSP for the dataset in the user's 
field. Refer to publication 2240011 for details of DSP use. 

Figure l.DP-1 illustrates a DSP. 

3 5 10 16 25 40 56 63 





UECF 
EOR 




l.DP-1. Dataset Parameter Area (DSP) 



Field 



Word 



Bits 



DPDN 





0-55 


DPBSY 


1 





DPERR 




1-12 


DPEOI 




1 


DPENX 




2 


DPEOP 




3 


DPEPD 




4 


DPEBN 




5 


DPEDE 




6 


DPEHE 




7 


DPERW 




8 



Description 

Dataset name 

Busy flag, circular I/O 

Not busy 

1 Busy 

Error flags: 

End of data on read; write past allo- 
cated disk space on write 

Dataset does not exist 

Dataset not open 

Invalid processing direction 

Block number error 

Unrecovered data error 

Unrecovered hardware error 

Attempted read after write or past EOD 
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DPLMT 

DPEOR 
DPEOF 

2240012 



Field Word Bits Description 

DPEPT 1 9 Dataset prematurely terminated 

1 10-12 Reserved 

DPSTS 1 14,15 Status 

00 Closed 

10 Open for input (I) 

01 Open for output (0) 

11 Open for I/O 

DPBFI 1 16-24 Blank compression character in ASCII 

(BFI=777g implies no compression) 

DPTRAN 1 34 Transparent mode for interactive dataset 

DPIA 1 35 Dataset is interactive 

DPMEM 1 36 Dataset is memory resident 

DPRDM 1 37 Random dataset flag 

Sequential dataset 

1 Random dataset 

DPUDS 1 38 Undefined dataset structure 

COS blocked dataset structure 

1 Undefined dataset structure 

DPEND 1 39 Write end-of-data flag 

DPFRST 1 40-63 Address of first word of buffer 

DPIBP 2 10-15 Bit position in current input word 

(logical I/O) 

DPIBN 2 16-39 Block number, read request 

System reads from block number until 
buffer is filled. The next block 
number is then in word 2. 

Address of current input word 

Remaining blank count 

Bit position in current output word 

Block number, write request 

System writes from block number until 
buffer is empty. The next block number 
is then in word 3. 

Address of current output word 

Uncleared end-of-file (EOF) 

Temporary block number; used by random 
I/O for last block read 

4 40-63 Address of last word+1 of buffer. LMT 

minus FRST defines buffer size. 

5 E0R flag 
5 2 EOF flag 



DPIN 


2 


40-63 


DPRBC 


3 


3-9 


DPOBP 


3 


10-15 


DPOBN 


3 


16-39 



DPOUT 


3 


40-63 


DPUEOF 


4 





DPTBN 


4 


16-39 



Part 5 
l.DP-2 



D-02 



Field 



Word 



Bits 



Description 



DPEOD 
DPRW 



DPPFI 
DPPRI 
DPRCW 

DPLPW 
DPBIO 



5 
5 



5 
5 
5 

6 
7 



3 EOD flag 

4 Previous operation read/write flag 

Read 

1 Wri te 

5-24 Previous file index; backward index to 
block containing previous EOF 

25-39 Previous record index; backward index 
to block containing previous EOR 

40-63 Control word address 

Previous RCW address in write mode 

Next RCW in read mode 

0-63 Last partial word; used for character 
mode I/O 

Buffered in/out busy 

Buffered in/out operation complete 

1 Buffered in/out operation incomplete 



DPBER 
DPBF 



DPBPD 



DPBEO 



DPBUBC 



DPBWC 



DPBWA 



7 
7 



1 
2-9 



6-9 



10-15 



16-39 



40-63 



Buffered I/O < 


srror flag 


Function code 


: 


000 


Read | 


partial 


010 


Read 


record 


040 


Write 


partial 


050 


Write 


record 


052 


Wri te 


end-of-file 


056 


Write 


end-of-data 


Processing- 


direction: 


1 


tead 




1 1 


4r\ te 





Termination condition: 
00 Partial 
10 Record 
12 File, write only 
16 Dataset, write only 

Unused bit count; must be specified on a 
write record request. Value returned on 
a read request. 

Word count. Number of words at DPBWA 
to read or write. Actual number of 
words read when request is completed. 

Word address of user data area 
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Field 


Word 


Bits 


Description 


DPTM 


8- 


15 


0-63 


Used by TIO as follows: 




8 




0-63 


(T.ZA) 




9 




0-63 


(T.ZB) 




10 




16-39 


(B.ZA) 




10 




40-63 


(B.ZB) 




11 




16-39 


(B.ZC) 




11 




40-63 


(B.ZD) 




12 




0-7 


JTA length/0 '1000 when registers are sav 




12 




8-15 


Bits - 7 of RBLK/WBLK A5 




12 




16-39 


(B.ZE) 




12 




40-63 


RBLK/WBLK BO 




13 




16-39 


DNT address 




13 




40-63 


(A7) JXT address 




13 




0-63 


RBLK/WBLK S5 during task recall 




14 




0-15 


Bits 8-23 of RBLK/WBLK A5 




14 




16-39 


RBLK/WBLK A2 




14 




40-63 


RBLK/WBLK A3 




15 




0-63 


RBLK/WBLK S6 




16- 


23 


0-63 


Reserved for future use by logical I/O 
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l.DR DEVICE RESERVATION TABLE - DRT 

STP resident contains a Device Reservation Table (DRT) for each logical 
mass storage device known to the system. The table (figure l.DR-2) 
consists of a header and a bit map. Each bit in the bit map represents 
one track on a disk. A set bit implies that the track is in use. 





D 


32 U8 63 





LDV 


1 


MAU 


™ V////////////A AIA 


2 


^^^^^^^^^^ 


3 

• 
• 
• 

67 


MAP 


• 
• 
• 

31 


Extended MAP for DD-29 ] 



Header 



Figure l.DR-1. Device Reservation Table (DRT) 



HEADER 

Field 

DRLDV 
DRMAU 
DRPDA 
DRAIA 

DRSZ 

DRMAP 

DRMAP 



Word 


1 

1 
1 



3-67 
3-131 



Bits Description 

0-63 Logical device name 

0-15 Maximum allocation units less flaws 

16-31 Number of AIs used for permanent dataset 

48-63 Total available AIs (number of unused 
bits) 

40-63 DRT map size in words 

0-63 Bit map, one bit per track 

0-63 Extended bit map, one bit per track, to 

accomodate extra cylinders of DD-29 
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l.DT DEVICE CHANNEL TABLE - DCT 



The Device Channel Table is STP-resident and is used by the disk driver 
to report completion of I/O and to report disk status. The DCT acts as 
a link between the channel and the Equipment Table (EQT). 

Figure l.DT-1 illustrates the Device Channel Table. 

4 8 12 16 2k 40 63 



1 

2 
3 
4 



TN 'W/, 


^%m^%%%%%^ 


SUB 


^m«%m^ 


W//////////////////S. 


FIN 


W////////////y. 




V/^/^////////////,. 


ACK 


V/////////////A 


%^^^/ 




QUE 


W///////////A 


W///////, 


^^^^^^^^ 


X CRCL 
/RSV / 


• 
• 
• 




\\IV& NUA ERR 


EQT 


r OFF^ RK 


TIF 






CTA 




• 
• 
• 



Header 



Entry 



Figure l.DT-1. Device Channel Table - DCT 



HEADER 






Field 


Word 


Bits 


DTTN 





0-23 


DTSUB 


1 


0-11 


DTFIN 


2 


0-11 


DTACK 


3 


0-11 


DTQUE 


4 


0-11 



Description 

Table name; "DCT" in ASCII 
Submitted channel bit map 
Completed channel bit map 
Acknowledged channel bit map 
Queued channel bit map 
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ENTRY 

There is one entry per channel 



Field 



Word 



Bits 



DTRSV 








DTOFF 





1 


DTIA 





2 


DTOA 





3 


DTCRCL 





4 


DTBRK 





5 


DTNUA 





8-15 


DTERR 





16-39 


DTEQT 





40-63 


DTTIF 


1 


0-63 


DTCTA 


2 


0-63 



Description 

Channel reserved 

Channel off 

Input channel active 

Output channel active 

Clear recall flag 

Break streaming flag 

Number of units active 

Cumulative channel error count 

Active equipment EQT address 

Time function issued 

Cumulative channel reserved time 
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l.DV DEVICE LABEL - DVL 

A device label for a device resides on the device and is initialized by 
deadstart initialization. The device label contains a flaw table for 
the device. The device label for the master device also contains a 
pointer to Dataset Catalog. 

Figure l.DV illustrates a DVL table. 



256 



512 



1023 



n 16 2k 32 40 48 bi 


LDV 


RT 


Reserved 


y/////////////A SDP OVP 


HSP 


%^^^%mm%^%^ 


FLC 


• 
• 
• 




FL 


T 




DSC 


y/////////w/Mmw/////M. 



Figure l.DV-1. Device Label (DVL) 



Field 



Word 



DVLBL 





DVMD 





DVLDV 


1 


DVRT 


2 



Bits Description 

0-23 Device label indicator; "DLB" in ASCII 

63 Master device flag 

0-63 Logical device name 

0-63 Real-time clock when DVL was written 



2240012 



Part 5 
l.DV-1 



Field 



Word 



Bits 



DVSDP 


4 


16-31 


DVOVP 


4 


32-47 


DVHSP 


4 


48-63 


DVFLC 


5 


48-63 


DVFLT 


256-510 


0-63 


DVDSC 


512-1022 


0-63 


DVCKS 


1023 


40-63 



Description 

First track of system dump area 

DSC overflow pages if DVMD^O (master device) 

DSC hash pages if DVMD^O (master device) 

Number of used AIs 

List of reserved AIs such as flaws, FE 
tracks, etc. 

Dataset Catalog DAT page images if 
DVMD^O (master device) 

Checksum 
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l.EC ERROR CODE TABLE (ECT) 

This STP resident table controls abort and reprieve processing done by UEP. 
It contains a 1-word entry for each system error code and is defined using 
the ERDEF macro. 



012 



n 



RF 



32 



40 



63 



% CLAS 



MSG 



Figure l.EC-1. Error Code Table (ECT) 



Field 
ECDN 

ECRF 

ECFE 
ECCLAS 



Word 









Bits 



1 

2-7 
32-39 



Description 

If set, the error message contains the 
dataset name. 

Reprievable error flag 

Reprievable 

1 Non-reprievable 

Bit number in JTFEFW giving fatal error 
flag; if not fatal . 

Error class. In order to interpret the 
value in the table entry, shift a 
rightmost 1 bit to the left as many 
times as specified in the table entry; if 
the table entry is 2, it would be 100 ? 



or 4 



10' 



ECMSG 



40-63 



Address of message 
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l.EQ EQUIPMENT TABLE - EQT 

This STP-resident table is used for working storage by the disk driver, 
for disk allocation, for passing requests to the disk driver, and for 
queue management. The EQT is illustrated in figure l.EQ-1. 



0123 



16 



24 28 32 



40 



48 52 



58 63 




5 

6 

7 

8 

9 

10 

11 

12 

13 
14 

15 

16 

17 

18 

19 



TN 



NUA 



NE 



ACT 



LST 



CYL 



TRK 



SEC 



CST 



NPR 



NRT 



Header 




' Entry 



Figure l.EQ-1. Equipment Table (EQT) 



2240012 



Part 5 
l.EQ-1 



D-02 



HEADER 

Field 

EQTN 

EQNUA 

EQNE 

ENTRY 

Field 

EQLDV 

EQMSD 

EQOFF 

EQNA 

EQRLS 

EQUP 



EQDT 

EQCH2 
EQCH1 
EQUT1 
EQDRT 
EQCPD 
EQTPC 
EQAU 

EQLNK 

EQQL 

EQQT 

EQQH 

EQACT 

EQLST 

EQCYL 

EQTRK 

EQSEC 

2240012 



Word 







Word 


1 
1 
1 
1 



1 
1 
1 
1 
2 
2 
2 

2 
3 
3 
3 
4 
5 
5 
5 
5 



Bits Description 

0-23 Table name; "EOT" in ASCII 

40-47 Next unit to be allocated 

48-63 Number of entries in table 



Bits Description 

0-63 Logical device name 

Master device flag 

1 Unit off 

2 Unit not available 

3 Flag set if datasets involving this LDV 
are to be released. 

4 *UP flag; set if *UP parameter is present 
in parameter file. This allows Startup 
to write a new device label if there is 
none so that new devices can be added 
without requiring an INSTALL type Startup. 

5 Disk type 

DD-19 

1 DD-29 

28-31 Secondary channel number 

34-37 Primary channel number 

38-39 Primary unit number 

40-63 DRT address 

0-15 Cylinders per disk 

16-23 Tracks per cylinder 

24-39 Blocks per allocation unit (sectors 

per track) 

40-63 Link to next equipment on channel 

0-15 Queue length 

16-39 Queue tail pointer 

40-63 Queue head pointer 

0-63 Anticipated on cylinder time 

16-31 Logical status 

40-51 Last cylinder position 

52-57 Last track position 

58-63 Last sector position 
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Field 

EQCST 
EQNPR 
EQNRT 
EQRSC 
EQTD 



EQRET 

EQCLM 

EQMGN 

EQISZ 

EQDB0 

EQSC 

EQCA 

EQTA 

EQSA 

EQMA 

EQSTS 

EQTRY 

EQDSP 

EQERR 

EQRER 

EQECYL 

EQEHD 

EQESCT 

EQIB1 

EQIB2 

EQIB3 

EQIB4 



Word 

6 
7 
8 
9 
10 



10 
10 
10 
10 

10 

1] 

i: 

l] 
i] 

l] 

12 
13 
13 

13 
14 
14 
14 
14 
16 
17 
18 
19 



Bits Description 

0-63 Cumulative seek time 

0-63 Number of physical requests 

0-63 Number of requests 

0-63 Number of requests not requiring a seek 

Transfer direction 

Read 

1 Wri te 

1 Retry flag 

2 Clear margin flag 
8-23 Last margin flag 

24-39 Buffer increment size 

40-63 Driver's saved B0 

0-15 Remaining sector count 

16-27 Current cylinder address 

28-33 Current track address 

34-39 Current sector address 

40-63 Current memory address 

0-63 Edited status 

0-15 Retry count 

16-39 DSP address or zero; used to pass DSP 
address to EXEC. 

40-63 Total disk errors 

16-39 Recoverable error count 

40-51 Last cylinder error address 

52-57 Last head error address 

58-63 Last sector error address 

0-63 Input buffer 1 

0-63 Input buffer 2 Contain error 

n crt T , , „ - i correction vector 

0-63 Input buffer 3 

0-63 Input buffer 4 
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LIB INTERACTIVE BUFFER TABLE - IBT 

The Interactive Buffer Table is STP resident and is used to manage the 

interactive Buffer Pool Table. 



Header: 












24 




32 40 


63 





TN 


XX/ 


/ yy^<////^. 


NBN 


1 


r ^^S^SSSSfSSs 








■vyy^ 


WPB 


BPA 




Figure 


1. 


IB-1. Ir 


iter 


•active Buffer Table (IBT) header 




Field 


Word 




Bits 




Description 




IBTN 







0-23 




Table name 




IBNBN 







40-63 




Number of available buffers 




IBWPB 


1 




32-39 




Words per bit 




IBBPA 


1 




40-63 




Buffer pool beginning address 





Entry: 







63 



BM 



BM 



Figure l.IB-2. IBT entry 



Field 



IBBM 



Word 



0-7 



Bits 



0-63 



Description 
Bit map 



I 
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l.JC JOB COMMUNICATION BLOCK - JCB 

The first 128 words of each user field consists of a Job Communication 
Block and is accessible to the user. 

01234567 16 31 kQ 56 G3 




Figure l.JC-1. Job Communication Block (JCB) 
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I 



I 



Field 
JCPOS 
JCCCI 

JCCPR 



JCIOAC 



t 



JCIOAP 



Word 

5-15 

16-63 



68 



68 



Bits 
31-63 
0-63 

0-63 



JCJN 


64 


0-55 


JCHLM 


65 


16-39 


JCFL 


65 


40-63 


JCNPF 


66 


0-15 


JCBFB 


66 


16-39 


JCDSP 


66 


40-63 


JCNLE 


67 


0-15 


JCLFT 


67 


40-63 


JCSIM 


68 





JCCSDB 


68 


1 


JCBP 


68 


2 


JCMRF 


68 


3 



JCIA 




68 


6 


JCEFI 




69 





JCCRL 




70 


0-63 


JCCRLS 




70 


32-63 


JCLDR 


102- 


-115 


0-63 


JCBDAT 




118 


0-63 


JCBTIM 




119 


0-63 


JCDIG 


120. 


-127 


0-63 



Description 

Current $CS position 

Control statement image packed 8 
characters per word 

Control statement parameters, expanded 
to 2 words per parameter 

Jobname; bits 56-63 must be zero 

High limit of user code 

Current field length 

Number of physical buffers and datasets 

Base address of I/O buffers 

Base address of DSP area 

Number of entries in LFT 

Base of LFT 

Simulator flag 

CSP debug flag 

JOB statement breakpoint (BP) flag 

Memory request flag. If set, dynamic 
field management by CAL, LDR, etc. is 
not allowed. 

I/O area current status flag 

user's I/O area is unlocked 

1 user's I/O area is locked 

I/O area previous status flag 

user's I/O area is unlocked 

1 user's I/O area is locked 

Interactive flag 

Enable floating interrupt flag; used by 
$FTLIB math routines to reset floating 
point interrupt flag. 

COS revision level 

COS revision number 

Unsatisfied externals 

Date of absolute load module generation 

Time of absolute load module generation 

Reserved for diagnostics 



Deferred Implementation 
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l.JT JOB TABLE AREA - JTA 



The JTA (figure l.JT-1) for a job resides below the field for the job and 
is not accessible to the user. 

Description 

Jobname; bits 55-63 must be zero 
Time spent executing in CPU (cycles) 
Time spent waiting to execute (cycles) 
Time spent waiting for I/O completion 
Disk blocks transferred 
User I/O requests 
User number, 1~15 characters 
Breakpoint registers 

Breakpoint instruction parcel 
Breakpoint parcel address 2 
Breakpoint parcel address 1 
Exchange package 
Vector length 
Vector mask 
Job streaming bit 
Control statement file stack 
Length of CSP-managed table area 
Address of CSP-managed table area 
Number of LFT entries in JTA 
Pointer to first of JTA LFT chain 

Time spent executing at last disconnect 
Buffered I/O request count 
Date/time of last rollout: must be in 
first sector of roll dataset 

SDT address used by RLD in EXP 

Return address used by Exchange Processor 

Exchange Processor request word: 

1 Error exit (bit 1 set) 

2 Normal exit (bit set) 

2 Flag set if JTEPA has a continuation 
address 

3 Flag set if request made by Job Scheduler 

4 Flag set if JTA expansion is requested 
for additional DAT space 



Field 


Word (octal ) 


Bits 


JTJN 





0-55 


JTTSX 


1 


0-63 


JTTSW 


2 


0-63 


JTTSD 


3 


0-63 


JTIOB 


4 


0-63 


JTIOR 


5 


0-63 


JTUSR 


6-7 


0-63 


JTBKP 


10-17 


0-63 


JTBKPP 


10 


0-15 


JTBKP2 


10 


16-39 


JTBKP1 


10 


40-63 


JTXP 


20-37 


0-63 


JTTVL 


23 


24-30 


JTVM 


40 


0-63 


JTSTR 


41 





JTCSTK 


42-51 


0-63 


JTTBLL 


60 


16-39 


JTTBL 


60 


40-63 


JTNLE 


62 


0-15 


JTFLF 


62 


40-63 


JTTSXL 


63 


0-63 


JTBIOC 


64 


0-63 


JTDTS 


65 


0-63 


JTSDT 


66 


16-39 


JTXPR 


66 


40-63 


JTEPX 


67 


0,1 



JTEPC 

JTEPJ 
JTEPM 

JTEPF 
2240012 



67 

67 
67 

67 



7-15 Flags from user exchange package 
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Figure l.JT-1. Job Table Area (JTA) 
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JCB 

Figure l.JT-1. Job Table Area (JTA) (continued) 
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Figure l.JT-1. Job Table Area (JTA) (continued) 
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Field Word (octal) Bits 
JTEPP 



JTEPA 
JTERC 
JTPM 

JTIOCU 

JTCRO 
JTIOC 



67 

67 
70 
70 
71 

72 

72 



16-39 

40-63 

7-15 

40-63 

40-63 



40-63 



JTSID 


73 


0-15 


JTDID 


73 


16-31 


JTJXT 


73 


40-63 


JTTID 


74 


0-63 


JTXMI 


75 


0-63 


JTDMI 


76 


0-63 


OTSEC 


77 





JTTLE 


77 


1 


JTDMPF 


77 


2 


JTEXIT 


77 


3 


JTEOF 


77 


4 


JTKIL 


77 


5 


JTRRN 


77 


6 


JTEFI 


77 


13 


JTDLM 


77 


14 


JTTRM 


77 


15 


JTABT 


77 


16 


JTCMSG 


77 


17 


JTLGFL 


77 


18 


JTJCBX 


77 


19 


JTSTAT 


77 


20 


JTTRM1 


77 


21 



Description 

P register from user exchange 
package 

Continuation address in EXP 

Reprieve error code 

PDD address; used in DISPOSE processing 

User field I/O count; includes buffer in 
and buffer out requests and I/O requests 
with DSP 

Outstanding reply from DQM to CIO - 
must be cleared before job can be ex- 
panded or contracted. 

Count of active I/O requests or 
functions 

Source ID (.2 characters) 

Destination ID (2 characters) 

JXT entry address 

Terminal ID 

Memory integral based on execution time 

Memory integral based on I/O wait time 

Security flag, set if CSP executing 

Time limit expired once 

Dump-in-progress flag 

EXIT statement flag 

End-of-file on $CS flag 

Job killed flag 

Job rerun flag 

Enable floating interrupt flag 

Disable log message 

Job in termination flag 

Job abort flag 

Enable conditional messages flag 

$L0G size exceeds I(3LGUSZ 

JCB bad flag 

Request dataset statistics flag 

Second pass through TRM flag 
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Field 


Word (octal ) 


Bits 


JTINIT 


77 


23 


JTNRR 


77 


24 


JTNRO 


77 


25 


JTIOAC + 


77 


26 



JTIOAP 



t 



77 



27 



JTOSUP 


77 


28 


JTISUP 


77 


29 


JTIA 


77 


30 


JTSKP 


77 


31 


JTB 


100-177 


40-63 


JTT 


200-277 


0-63 


JTVO 


300-377 


0-63 


JTV1 


400-477 


0-63 


JTV2 


500-577 


0-63 


JTV3 


600-677 


0-63 


JTV4 


700-777 


0-63 


JTV5 


1000-1077 


0-63 


JTV6 


1100-1177 


0-63 


JTV7 


1200-1277 


0-63 


JTDMP 


1300-1317 


0-63 


JTCDP 


1320-1337 


0-63 


JTLDP 


1340-1357 


0-63 


JTEDP 


1360-1377 


0-63 


JTMSG 


1400-1417 


0-63 


JTPDD 


1420-1437 


0-63 


JTEDN 


1420-1427 


0-63 


JTAREG 


1440-1447 


0-63 



JTSREG 1450-1457 



0-63 



Description 

Job initiated flag 
Not rerunnable if set 
Disables no rerun if set 

I/O area current status flag 

user's I/O area unlocked 

1 user's I/O area locked 

I/O area previous status flag 

user's I/O area unlocked 

1 user's I/O area locked 

Interactive output suspended (recovery) 
Interactive input suspended (recovery) 
Interactive flag 

Control statement skip flag 
B registers 

T registers 

ister elements 

ister elements 

ister elements 

ister elements 

ister elements 

ister elements 

ister elements 

ister elements 

Copy of exchange package for error 
processing 

Control statement ($CS) DSP 

Logfile ($L0G) DSP 

EXU DSP; also used by DUMPJOB 

Last logfile message issued 

Permanent dataset descriptor entry 
used by job termination 

DNT for EXU 

A-register save area for RESUME/CONTINUE 
only 

S-register save area for RESUME/CONTINUE 
only 



VO 


regi 


VI 


regi 


V2 


regi 


V3 


regi 


V4 


regi 


V5 


regi 


V6 


regi 


V7 


regi 



t 
Deferred implementation 
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Field Word (octal) Bits 



JTDTM 
JTCCI 



1460-1657 
1660-1671 



JTODN 1672-1673 
JTJCB 1674-1676 



JTCHK 

JTST 

JTFEFW 
JTFE03 
JTFE10 
JTFE11 
JTFE23 
JTFE24 
JTFE41 
JTFE58 
JTFE51 
JTFE43 
JTFENR 

JTMSK 

JTRXP 

JTWUP 

JTA0,.., 
JTA7 

JTS0,.., 
JTS7 

JTINS 

JTCSB 

JTLGF 

JTJSQ 

JTL 

JTMR 

JTRL 
JTMRCC 



1677 
1700 
1701 
1701 
1701 
1701 
1701 
1701 
1701 
1701 
1701 
1701 
1701 
1702 
1702 
1702 
1740-1747 

1750-1757 

1760-1777 
2000-2777 
3000-3777 
4000 
4000 
4001 

4001 
4001 



0-63 
0-63 

0-63 

0-63 

0-63 

0-63 

0-63 

1 

2 

3 

4 

5 

6 

7 

8 

9 

63 

0-15 

16-39 

40-63 

0-63 

0-63 

0-63 
0-63 
0-63 
0-15 
40-63 
15 

16-39 
40-63 



Description 

Save area for Task I/O 

80 characters of control statement being 
prescanned 

Two-word ODN table used by RELEASE and 
DISPOSE 

Three words from user JCB starting with 
W0JCHLM 

Reprieve checksum supplied by user 

Reprieve status word 

Reprieve fatal error flag word 

No DAT space 

No disk space 

SDR is full 

Job time limit exceeded 

Operator dropped user job 

Enter allowed on ACCESS only 

Error exit 

LFT chain pointer invalid 

User log size invalid 

Not reprievable 
Reprieve mask 

Reprieve XP address in user area 
Reprieve entrv address in user area 
A register save area for EXP 

S register save area for EXP 

Reserved for installation 
Control statement ($CS) buffer 
Logfile ($L0G) buffer 
Job sequence number 
Length of Job Table Area 
Memory request outstanding flag 

Requested length of JTA expansion 

Count of datasets waiting for JTA 
memory 
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Field Word Bits 

JTADL 4002-(W@JTADL+ 0-63 
LE0DDL-1) 

JTDPS W@JTADL+LE@DDL 0-63 

JTLFL W0JTDPS+1 0-63 

JTJXTI (W@JTLFL+1)- 

(W@JTJXTI+61 8 ) 0-63 

JTRDAT (W@JTJXTI+62 8 )- 

(W@JTRDAT+307 8 )0-63 

JTPOOL W@JTRDAT+310 8 
MPST 



MPID 16-39 



MPSIZE 




40-63 


JTDNH 


W0JTPOOL+1 




JTDBL 




16-39 


JTDFL 




40-63 


JTCS 


W@JTDNH+1 


0-63 


JTLOG 


W0JTCS+ 
LE@DNT+3 





Description 

DDL for OPEN and DUMPJOB; up to six 
words long 

Control word for Task I/O DSP save area 

User last word before rollout 

Image of JXT at rollout 

Image of roll DAT 
First word of JTA memory pool 
Status of memory area 

Available 

1 In use 

Memory pool identification 
07070707 Job Table Area 

Size of the memory area 
Head of the DNT chain 

DNT backward link 

DNT forward link 
Control statement ($CS) DNT 
Logfile ($L0G) DNT 
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l.JX JOB EXECUTION TABLE - JXT 

The JXT in STP memory contains an entry for each job that has begun 
processing. The JXT is used to control all active jobs in the system. 

The JXT may contain from 1 to 63 entries; the first entry is reserved 
for the operating system, itself. 

The JTA entry and the JXT entry for a particular job contain each other's 
addresses. Word in both entries contains the 7-character job name. 

A JXT entry is illustrated in figure l.JX-1. 



Field 



Word 



Bits 



JXJN 





0-55 


JXSTCH 


1 


0-55 


JXORD 


1 


56-63 


JXSTAT 


2 


0-22 


JXEPC 


2 


23-27 


JXNR 


2 


28-39 


JXJTA 


2 


40-63 


JXSDT 


3 


0-15 


JXBLO 


3 


16-27 


JXFLO 


3 


28-39 


JXRJS 


3 


40-63 


JXCP 


4 


0-39 


JXCJS 


4 


40-63 


JXP 


5 


0-7 


JXMP 


5 


8-39 


JXDNT 


5 


40-63 


JXTSX 


6 


0-63 


JXIOB 


7 


0-63 


JXMEM 


8 


0-63 


JXEVW 


9 


0-63 


JXDLY 


10 


0-63 


JXTL 


11 


0-63 



Description 

Jobname 

Job status in displayable form (7 characters) 

Ordinal number (0-63) of the JXT entry 

Status; see part 1, section 3.8.6 

Reason for abortion if the A status bit is set 

See Job Scheduler equates for A$oxcx in 

COS for abort codes. 

Number of times the job has been rolled in 

Job table area address 

SDT offset for this job's SDT entry 

Backward link as a JXT offset 

Forward link as a JXT offset 

Requested job size including JTA 

CPU priority (based on resource use) 

Current job size including JTA 

Priority from JOB statement 

Floating memory priority (based on JXP) 

Rolled image's DNT entry address 

Time spent executing as of last rescheduling 

Disk blocks transferred as of last rescheduling 

Saved memory request word (J$ALL0C) 

Saved event word (J$AWAIT) 

Wake-up time in cycles (J$DELAY) 

Time limit in cycles 
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16 



23 28 



4-0 



56 



63 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 



21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 

42 



JN 


'///////\ 


STCH 


ORD 


STAT 


EPC 


NR 


JTA 


SDT 


BLO 


FLO 


RJS 




CP 


CJS 


P 


MP 


DNT 






TSX 








IOB 








MEM 








EVW 






DLY 


TL 


LFM 


SUS 


TSXI 


I0BI 


DTI 


LRC 




LSC 








LISC 






PI 


P2 


NRR ,DMR 


P3 






♦. SW 


\ 


w\ 


AUT 


JTL 




*TRM ] tVL 
L -*A 


Rollfile DNT 







Figure l.JX-1. Job Execution Table (JXT) entry 



2240012 



Part 5 

l.JX-2 



D-02 



Field 



Word 



Bits 



JXLFM 


12-21 


0-63 


JXSUS 


22 


0-63 


JXTSXI 


23 


0-63 



JXIOBI 



24 



0-63 



JXDTI 


25 


0-63 


JXLRC 


26 


0-63 


JXLSC 


27 


0-63 


JXLISC 


28 


0-63 


JXP1 


29 


0-63 


JXP2 


30 


0-63 


JXP3 


31 


0-63 


JXNRR 


32 





JXTRM 


32 


1 


JXSW 


32 


2-7 


JXDMR 


32 


8 



JXIA 


32 


9 


JXLVL 


32 


10-12 


JXAUT 


32 


16-40 


JXJTL 


32 


40-63 




33-42 


0-63 



Description 

Last log-file message 

Reply word for J$SUSPK 

Time spent executing in past scheduling 
interval 

Disk blocks transferred in past 
scheduling interval 

Date and time initiated 

Date and time of last residence change 

Date and time of last status change 

Date and time of last I/O status change 

Temporary storage word 1 for TRACEMP 

Temporary storage word 2 for TRACEMP 

Temporary storage word 3 for TRACEMP 

Job rerun flag; set if job cannot be rerun 

Job in termination flag 

Sense switches 

Don't-mark-recoverable flag - set when 
a request is made to declare a job 
non-recoverable; cleared when the job 
is connected. 

Interactive flag 

Current procedure level 

Address of Active User Table (AUT) for 
interactive jobs 

Length of the Job Table Area (JTA) 
DNT entry for job's roll file 



There are four temporary tables for displaying the name, SDT offsets, 
CPU priority, memory priority, and status for each job in the JXT. These 
tables, which will be removed when a complete job display is implemented, 
follow the JXT and precede the MST in memory. Each table consists of a 
single word for each JXT entry; in each table, the initial entry (for 
JXT ordinal zero) contains the table description in ASCII (that is, 
"NAME+SD0", "CPU PRI", "MEM PRI" , or "STATUS"). 
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The first table (job names and SDT ordinals) immediately follows the JXT. 
The SDT ordinal occupies the rightmost 8 bits of a word in this table. 
The remainder of the word is needed for the 7-character name. 

The second and third tables (CPU and memory priorities) contain float- 
ing point values in ASCII to four decimal places. Entries in these tables 
are updated by the Job Scheduler at the end of each scheduling interval 
when the priorities are recomputed. However, if there are fewer than 
I@CPPRI + 2 jobs in memory at the end of a scheduling interval, or if 
I0AGECP is zero, the CPU priorities are not recomputed. (I@CPPRI determines 
the CPU priority algorithm and is either or 1. I@AGECP also is or 1; 
if it is 0, aging of CPU priorities is disabled and the changing memory 
priorities are used instead.) Similarly, if there are no unsatisfied 
memory requests, the memory priorities are not recomputed. 

The fourth table (job statuses) immediately precedes the MST. It contains 
copies of the JXSTCH and JXORD fields from the JXT. The appropriate entry 
is updated whenever the status of a job is changed by the Job Scheduler. 
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LLC LINK CONFIGURATION TABLE - LCT 



The Link Configuration Table resides in STP memory. It contains an entry 
for each physically connected front-end. 



Figure l.LC-1 illustrates the LCT format, 

1J5_ 2k 

' 





1 



hO 



48 



56 



63 



_ «" _ /mm//////////mz ■* 


wzz. 


'■ 


mmmm^/A 


CHN NID ST 


W2%>. 


^%^ DBS 


SBS 


\ 



} Head 



er 



Entry 



Figure l.LC-1. Link Configuration Table (LCT) 



HEADER 

Field 

LCNM 
LCNA 



Word 






Bits 

0-23 
56-63 



Description 

Table name; "LCT" in ASCII 

Number of active physical channels 



ENTRY 

Fi el d 

LCCHN 

LCNID 

LCST 

LCDBS 

LCSBS 



Word 



Bits 






40-47 





48-55 





56-63 


1 


16-39 


1 


40-63 



Description 

Software channel pair number 
Number of logical IDs for channel 
Number of streams per physical channel 
Size of disk buffer 
Maximum size of segment 
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l.LF LOGICAL FILE TABLE - LFT 

The Logical File Table resides below the DSP area in the user field. It 
contains a 2-word entry for each dataset name and each alias for a dataset 
(figure l.LF-1). The LFT and NLE fields of the JCB give the base address 
and number of entries in the LFT, respectively. 








hO 




62 





DN 






1 


^m^^M^m^mm 


DSP 



Figure l.LF-1. Logical File Table (LFT) entry 



ENTRY 

Field 

LFDN 
LFDSP 



Word Bits Description 

0-63 Dataset name or alias 

1 40-63 DSP address 
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l.LG.l REQUEST WORD TO MSG - LGI 



< 



PCS 

1 



19 



28 31+ 



i+O 



63 




A 



TYP 



SUB 



LEN 



ADDR 



^FCU 



Figure l.LG-1. Request word to MSG (LGI) 



Field 


Word 


Bi 


ts 


Description 
System log flag 








LGIFCS 










LGIFCU 





] 




User log flag 








LGITYP 





19- 


-27 


Major type 








LGISUB 





28- 


■33 


Subtype 








LGILEN 





34- 


■39 


Length 








LGADDR 





40- 


-63 


Starting address 


of 


mess 


age 



l.LG. 2 RECORD IN SYSTEM LOG - LGR 




1 
2 
3 
ri 



10 


>h 


2k 


i+O 




63 


tf u 




TIM 






\ TYP 


SUB 


mm 


JSQ 


LEN 




JN or 


binary data 








ASCII text or binary data 




i 
.. 1 



Figure l.LG-2. Record in system log (LGR) 



Field 

LGRTIM 

LGRU 

LGRTYP 

LGRSUB 

LGRJSQ 

LGRLEN 



Word 



Bits 






0-64 


1 





1 


1-9 


1 


10-15 


1 


24-39 



40-63 



Description 

Time 

User flag; message also in $L0G 

Major type 

Subtype 

Job sequence number, if associated 
with a job, otherwise 

Length 
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LGRJN 



3-n 



0-63 Jobname, if associated with a job; 
otherwise, beginning of binary data 

0-63 ASCII text or binary data 



1.LG.3 $L0G RECORD IN MEMORY POOL (BATCH MODE) - LGUQ 








6 


24 




32 4 


+ 8 


56 ( 




1 




Chain 


item words 






2 


L 


V//////////////A 


JQ_ 


JX 


3 


R 


4 


Tl 


5 


CI 


6 


CF 


S 


LV 


SP 


7 


ID 


8 



















63 



Figure l.LG-3. $L0G Record in Memory Pool (LGUQ) 



I 



Field 


Word 


Bits 


Description 


LGUQL 


2 


0-5 


Length of $LOG record 


LGUQJQ 


2 


24-39 


Job sequence number 


LGUQJX 


2 


40-63 


JXT address 


LGUQR 


3 


0-63 


Spaces 


LGUQTI 


4 


0-63 


Time 


LGUQCI 


5 


0-63 


CPU time (integer portion) 


LGUQCF 


6 


0-31 


CPU time (fractional portion) 


LGUQS 


6 


32-47 


Two spaces 


LGUQLV 


6 


48-55 


Procedure level 


LGUQSP 


6 


56-63 


Spare space 


LGUQID 


7 


0-63 


Task ID 


LGUQT 


8-n 


0-63 


Message text 
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1.LG.4 $LOG RECORD IN MEMORY POOL (INTERACTIVE MODE) - LGUQ 

6 24 32 40 48 56 63 












1 




Chain item words 


2 


L 


yyyyyyy 


^^^ 


JQ 


JX 


3 


BCW 


4 








• 




T 




n 








n+1 


RCW 



Figure l.LG-4 $L0G Record in Memory Pool (LGUQ) 



Field 


Word 


Bits 


Description 


LGUQL 


2 


0-5 


Length of $L0G record 


LGUQJQ 


2 


24-39 


Job sequence number 


LGUQJX 


2 


40-63 


JXT address 


LGUQBCw 


3 


0-63 


Block control word 


LGUQT 


4 - n 


0-63 


Message text 


LGUQRCW 


n+1 


0-63 


Record control word 
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l.LG-5 LOG JXT TABLE - LGJ 

The LGJ table contains a one-word entry for each job having records 
placed in its user logfile ($L0G) . The entries are in the same ordinal 
positions as their JXT entries. 



01 



R0 



10 



25 



<t9 



63 



. w ^^^. 


QA 


JSQ 



10 



Figure l.LG-5. $L0G Record in JXT Table (LGJ) 



Field 
LGJRO 



Word 



Bits 



LGJQR 





1-9 


LGJIO 





10 


LGJQA 





25-48 


LGJJSQ 





49-63 



Description 

Rollout flag - Log Manager tried to 
write message to this job while it 
was rolled out 

Number of queue entries remaining 

I/O busy flag 

Address of queue entry 

Job sequence number 



2240012 



Part 5 
l.LG-4 



D-02 



l.LS LINK INTERFACE STREAM TABLE - LST 



Eight input stream LSTs and eight output stream LSTs are contained 
within each LXT entry. Each LST is used only by the Station Call 
Processor and contains SCP working storage. 



Figure l.LS-1 illustrates an LST format. 




UO 



NEXT 



SGN 



RSC 



RSCZ 



SBZ 



DBZ 



SPR 



SBL 



PDD 



RTN 



SV1 



CSCT 



LX 



SDT 



RSCT 



SBB 



DBB 



FRST 



IN 



OUT 



LMT 



SBC 



SV2 



SV3 





Figure 


l.LS-1. 


Field 


Word 


Bits 


LSSTN 





0-7 


LSRSF 





8-15 


LSNEXT 





16-39 


LSLX 





40-63 


LSCSSC 


1 


0-7 


LSSSC 


1 


8-15 


LSSGN 


1 


16-39 


LSSDT 


1 


40-63 


LSPRSC 


2 


0-23 


LSRSC 


2 


24-31 


LSRSCZ 


2 


32-39 



63 



Link Interface Stream Table (LST) 

Description 

Stream number 

Right shift count 

Link to next LST 

Extension table address 

Current send stream control code 

Next send stream control code 

Segment number 

SDT address 

Process received stream control code 

Received stream control code 

Next received stream control code max- 
imum value 
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Field 



Word 



LSRSCT 


2 


LSSBZ 


3 


LSSBB 


3 


Flags 


4 


LSSBRF 


4 


LSPR 


4 


LSTRM 


4 


LSLOG 


4 


LSDBZ 


4 


LSDBB 


4 


LSSPR 


5 


LSFRST 


5 


LSSBL 


6 


LSIN 


6 


LSPDD 


7 


LSOUT 


7 


LSRTN 


8 


LSLMT 


8 


LSSTC 


9 


LSSBC 


9 


LSSV1 


10 


LSSV2 


10 


LSCSCZ 


11 


LSCSCT 


11 


LSSV3 


11 



Bits Description 

40-63 Next received stream control start 

16-39 Segment buffer size 

0-63 Segment buffer base address 

0-7 

Segment buffer ready 

1 Outstanding PUTREQ 

2 Terminate for PPN, CAN, or MCL 

3 LOGON received 
16-39 Disk buffer size 

40-63 Disk buffer base address 

16-39 Segment buffer pointer 

40-63 Disk buffer "first" address 

16-39 Segment buffer limit address 

40-63 Disk buffer "in" address 

16-39 Pointer to PDD for stream request 

40-63 Disk buffer "out" address 

16-39 Return address for deferred processing 

40-63 Disk buffer limit address 

0-39 Send stream transmission word count 

40-63 Segment bit count 

16-39 Save Al = LIT for common reply 

40-63 Save A2 = LXT for common reply 

0-7 Current stream control code maximum 

16-39 Current stream control code table 

40-63 Save A3 = LST for common reply 
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l.LT- LINK INTERFACE TABLE - LIT 

The Link Interface Table is STP resident. It is used by both the Station 
Call Processor and EXEC and contains SCP-EXEC communication areas, 
working storage, and channel buffers. An LIT entry is assigned by SCP 
at deadstart to each channel which is to be used by SCP for link 
interface communications. 

Figure l.LT-1 illustrates the LIT. 



Field 



LTINT 



LTCHN 



Word 



LTLID 





LTLX 





LTON 


1 


LTSGZ 


1 


LTSZB 


1 


LTMSSG 


2 


LTSSGZ 


2 


LTSSZB 


2 


LTCBSZ 


3 


LTCBS 


3 


LTSBT 


4 


LTSBC 


4 


LTSBZ 


4 


LTSBQH 


4 


LTDBT 


5 


LTDBC 


5 


LTDBZ 


5 


LTDBQH 


5 


LTCKSZ 


6 


LTLXQH 


6 


LTLXC 


7 



Bits Description 

Channel interrupt flag. Set by EXEC 

upon completion of O/I, cleared by SCP. 

1-6 Channel pair number (input channel 
number divided by 2). (SCP) 

24-39 Link ID (SCP) 

40-63 Extension table address (SCP) 

Link on flag 

22-39 Segment size in words (SCP) 

40-63 Segment size in bits (SCP) 

8-15 Maximum number of subsegments in a 
segment (SCP) 

22-39 Subsegment size in words (SCP) 

40-63 Subsegment size in bits (SCP) 

16-39 Channel buffer space size (SCP) 

40-63 Channel buffer space base address (SCP) 

0-7 Total segment buffer count 

8-15 Free segment buffer count 

16-39 Segment buffer size in words (SCP) 

40-63 Segment buffer queue head (SCP) 

0-7 Total disk buffer count 

8-15 Free disk buffer count 

16-39 Disk buffer size in words (SCP) 

40-63 Disk buffer queue head (SCP) 

32-39 Checksum width 

40-63 Extension table queue head address 

8-15 Extension table entry count 



2240012 



Part 5 
l.LT-1 



C-02 




Figure l.LT-1. Link Interface Table (LIT) 
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Figure l.LT-1. Link Interface Table (LIT), continued 
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Field 



Word 



Bits 



Description 



LTCNXT 7 16-39 Link to first active extension table 

(SCP) 

LTNEXT 7 40-63 Link to next LIT entry (SCP) 

LTIA 8 Input active flag (EXEC) 

LTILAL 8 16-39 Input LCP absolute limit address (SCP) 

LTILAB 8 40-63 Input LCP absolute base address (SCP) 

LTILWC 9 46-63 Input LCP word count (EXEC) 

LTISSZ 10 0-15 Input subsegment size in words (SCP) 

LTISAL 10 16-39 Input segment absolute limit address 

(LCP) 

LTISAB 10 40-63 Input segment absolute base address 

(LCP) 

LTISWC 11 46-63 Input segment word count (EXEC) 

LTISSN 12 8-15 Current input subsegment number (EXEC) 

LTISSB 12 16-39 Input subsegment base address (EXEC) 

LTISSL 12 40-63 Input subsegment limit address (EXEC) 

LTIERC 14 0-15 Input error retry count (EXEC) 

LTITE 14 16-39 Input total error message count (EXEC) 

LTITM 14 40-63 Input total non-error message count 

(EXEC) 

LTITSS 15 8-39 Input total subsegments count (EXEC) 

LTITS 15 40-63 Input total segments count (EXEC) 

LTILC 16 0-15 Input LCP buffer word count (SCP) 

LTILL 16 16-39 Input LCP buffer limit address (SCP) 

LTILB 16 40-63 Input LCP buffer base address (SCP) 

LTILCP 18-23 0-63 Input LCP buffer area (SCP) 

LTOA 24 Output active flag (EXEC) 

LTOLAL 24 16-39 Output LCP absolute limit address (SCP) 

LTOLAB 24 40-63 Output LCP absolute base address (SCP) 

LTOLWC 25 46-63 Output LCP word count (SCP) 

LTOSSZ 26 0-15 Output subsegment size in words (SCP) 

LTOSAL 26 16-39 Output segment absolute limit address (SCP) 

LTOSAB 26 40-63 Output segment absolute base address (SCP) 

LTOSWC 27 46-63 Output segment word count (SCP) 

LTOSSN 28 8-15 Current output subsegment number (EXEC) 
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Field 



Word 



Bits 



LTOSSB 


28 


16-39 


LTOSSL 


28 


40-63 


LTOERC 


30 


0-15 


LTOTE 


30 


16-39 


LTOTM 


30 


40-63 


LTOTSS 


31 


8-39 


LTOTS 


31 


40-63 


LTOLC 


32 


0-15 


LTOLL 


32 


16-39 


LTOLB 


32 


40-63 


LTOLCP 


34-39 


0-63 


LTXLC 


40 


0-15 


LTXLL 


40 


16-39 


LTXLB 


40 


40-63 


LTXLCP 


42-47 


0-63 


LTILTC 


50 


0-15 


LTILTL 


50 


16-39 


LTILTB 


50 


40-63 


LTILTP 


51-53 


0-63 


LTOLTC 


56 


0-15 


LTOLTL 


56 


16-39 


LTOLTB 


56 


40-63 


LTOLTP 


57-59 


0-63 


LTXLTP 


60-63 


0-63 


LTXONE 


60 


0-63 


LTZRO 


61 


0-63 


LTXCKS 


62 


0-63 


LTXLTL 


63 


16-39 


LTXLTB 


63 


40-63 


LTPDD 


64-79 


0-63 



Description 

Output subsegment base address (EXEC) 

Output subsegment limit address (EXEC) 

Output error retry count (EXEC) 

Output total error message count (EXEC) 

Output total non-error message count 
(EXEC) 

Output total subsegments count (EXEC) 

Output total segments count (EXEC) 

Output LCP buffer word count (SCP) 

Output LCP buffer limit address (SCP) 

Output LCP buffer base address (SCP) 

Output LCP buffer area (SCP) 

Output LCP buffer word count (EXEC) 

Output LCP buffer limit address (EXEC) 

Output LCP buffer base address (EXEC) 

Output LCP buffer area (EXEC) 

Input LTP buffer word count (SCP) 

Input LTP buffer limit address (SCP) 

Input LTP buffer base address (SCP) 

Input LTP buffer area (SCP) 

Output LTP buffer word count (SCP) 

Output LTP buffer limit address (SCP) 

Output LTP buffer base address (SCP) 

Output LTP buffer area (SCP) 

Error LTP 

Error - all ones pattern 

Error - all zeros pattern 

Error - checksum 

Error - LTP limit address 

Error - LTP base address 
Channel PDD table (SCP) 
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l.LX LINK INTERFACE EXTENSION TABLE - LXT 



The Link Interface Extension Table is STP resident. It is used only by 
the Station Call Processor and contains SCP working storage. Also 
contained in each LXT entry are eight input stream LSTs and eight output 
stream LSTs. An LXT entry is assigned to an active LIT entry for each 
front-end ID at LOGON and deassigned at LOGOFF. 



Field 



Word 



Bits 



LXLID 





0-15 


LXCHN 





34-39 


LXLT 





40-63 


LXIAST 


1 





LXSTYP 


1 


1-2 


LXSTBA 






LXSTIA 






LXSTBO 






LXIACT 


1 


3-18 


LXCXSZ 


1 


32-39 


LXRSTQ 


2 


0-63 


LXNRM 


2 


0-15 


LXRSQT 


2 


32-47 


LXRSQH 


2 


48-63 


LXAIST 


3 


16-23 


LXAOST 


3 


24-31 


LXAAST 


3 


32-39 


LXLMIS 


5 


16-23 


LXLMOS 


5 


24-31 


LXLMAS 


5 


32-39 


LXLMSS 


5 


40-47 


LXLSSZ 


5 


48-63 


LXLDSZ 


6 


40-63 


LXOMIS 


7 


16-23 


LXOMOS 


7 


24-31 


LXOMAS 


7 


32-39 


LXSGZ 


8 


22-39 


LXDRMC 


8 


40-63 



Description 

Link ID 

Channel pair number 

LIT address 

Interactive request received flag 

Station Type 

Batch only 

1 Interactive only 

2 Both 

Interactive message count 

Checksum width (0, 8, 16, 32, or 64) 

Interactive restart Q control word 

Number of messages 

Q Tail 

Q Head 

Current active input streams 

Current active output streams 

Current total active streams 

Logon maximum active input streams 

Logon maximum active output streams 

Logon maximum total active streams 

Logon maximum subsegments 

Logon subsegment size 

Maximum output dataset size (in 512-word 
blocks) 

Operator maximum active input streams 

Operator maximum active output streams 

Operator maximum total active streams 

Segment size in words 

Deferred received message code 
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Figure l.LX-1. Link Interface Extension Table (LXT) 



2240012 



Part 5 
l.LX-2 



D-02 





8 22 32 


<+0 63 


32 


^m^^m^^^^ 


ISQH 


33 


w////////////. 


RTN 


34 


ISTN W//M"/////W//////^//. 


ILS 


35 


^^^m^^^^m^m^^ 


36 

• 
• 
• 

131 


8 input LST tables 
(for details, see p. l.LS-1) 


132 


<mm^^^mm^ OSQH 


133 


«<m^^m^^^^^m^ 


134 


OS™ ^^^%%%%%^ 


OLS 


135 


^^^mm^^m%^%^^ 


136 

• 
• 
• 

231 


8 output LST (OST) tables 
(for details, see p. l.LS-1) 


232 

• 
• 
• 


RLTP 


235 

• 
• 
• 


SLTP 


238 


OPSV 


240 


7 





262 



2 



SSEG 



Figure l.LX-1. Link Interface Extension Table (LXT), continued 
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LXSZB 


9 


16-39 


LXSSZB 


9 


40-63 


LXSLWA 


10 


8-31 


LXESBC 


10 


32-63 


LXESBZ 


11 


16-39 


LXESBB 


11 


40-63 


LXWQH 


12 


40-63 


LXRQH 


13 


40-63 


LXSQH 


14 


40-63 


LXCNXT 


15 


16-39 



Field Word Bits Description 

Segment size in bits 

Subsegment size in bits 

LWA+1 of segment 

Diagnostic echo segment bit count 

Diagnostic echo segment size 

Diagnostic echo segment address 

Waiting SDT queue head address 

Receiving SDT queue head address 

Sending SDT queue head address 

Link to next active LXT entry for this 
channel 

LXNEXT 15 40-63 Link to next available or active LXT 

entry 

LXRDID 16 0-15 Received destination identifier 

LXRSID 16 16-31 Received source identifier 

LXRNSS 16 32-39 Received number of subsegments 

LXRMN 16 40-47 Received message number 

LXRMC 16 48-55 Received message code 

LXRMSC 16 56-63 Received message subcode 

LXRSTN 17 0-7 Received stream number 

LXRSGN 17 8-31 Received segment number 

LXRSBC 17 32-63 Received segment bit count 

LXRISC 19 0-63 Received input stream control bytes 

LXROSC 20 0-63 Received output stream control bytes 

LXVRMZ 22 0-7 Verify received message code maximum 

value 

LXVRMC 22 8-31 Verify received message code table 

address 

LXPRMZ 22 32-39 Process received message code maximum 

value 

LXPRMC 22 40-63 Process received message code table 

address 

LXXMN 23 0-7 Expected message number 

LXRSBZ 23 22-39 Received segment buffer size 

LXRSBB 23 40-63 Received segment buffer base address 

LXSDID 24 0-15 Send destination identifier 

LXSSID 24 16-31 Send source identifier 
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Field 



Word 



Bits 



Description 



LXSNSS 

LXSMN 

LXSMC 

LXSMSC 

LXSSTN 

LXSSGN 

LXSSBC 

LXSISC 

LXSOSC 

LXPAMZ 

LXPAMC 



24 
24 
24 
24 
25 
25 
25 
27 
28 
30 

30 



32-39 

40-47 

48-55 

56-63 

0-7 

8-31 

32-63 

0-63 

0-63 

32-39 

40-63 



LXSSBZ 


31 


22-39 


LXSSBB 


31 


40-63 


LXISQH 


32 


40-63 


LXST 


33 


16-39 


LXRTN 


33 


40-63 


LXISTN 


34 


0-7 


LXILS 


34 


40-63 


LXIST 


36-131 


0-63 


LXOSQH 


132 


40-63 


LXOSTN 


134 


0-7 


LXOLS 


134 


40-63 


LXOST 


136-231 


0-63 


LXRLTP 


232-234 


0-63 


LXRONE 


232 


0-63 


LXRZRO 


233 


0-63 


LXRCKS 


234 


0-63 


LXSLTP 


235-237 


0-63 


LXSONE 


235 


0-63 


LXSZRO 


236 


0-63 


LXSCKS 


237 


0-63 


LXOPSV 


238-239 


0-63 


LXSSEG 


240-262 


0-63 



Send number of subsegments 

Send message number 

Send message code 

Send message subcode 

Send stream number 

Send segment number 

Send segment bit count 

Send input stream control bytes 

Send output stream control bytes 

Process acknowledged message code 
maximum value 

Process acknowledged message code 
table 

Send segment buffer size 

Send segment buffer base address 

Input LST queue head address 

Pointer to active LST address 

Return address for active LST 

Input stream number 

Input stream LST address 

Input LST table 

Output LST queue head address 

Output stream number 

Output stream LST address 

Output LST table 

Receive - LTP 

Receive - all ones pattern 
Receive - all zeros pattern 
Receive - checksum 
Send - LTP 

Send - all ones pattern 
Send - all zeros pattern 
Send - checksum 
Save area for op requests 
"Special protocol" segment 
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l.MP MEMORY POOL - MP 

Memory pool areas are surrounded by header and trailer words that control 
the allocation and deallocation of the areas. A memory pool is depicted 
in figure l.MP-1. 
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Figure l.MP-1. Memory Pool 



SIZE 



Field 



MPST 



MPID 



MPSIZE 



Word 
0,n,etc. 



Bits 



0,n,etc. 16-39 



0,n,etc. 40-63 



Description 

Status of the memory area: 

Available 

1 In use 

Memory pool identification: 

01010101 Pool 1 
OxOxOxOx Pool x 

Size of the memory pool 
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l.MS MEMORY SEGMENT TABLE - MST 

The MST in STP memory contains a one-word entry for each segment of 
memory that has been allocated by the Job Scheduler plus additional 
entries that describe free segments. MST entries are stored in 
ascending order according to the beginning address of the segment 
(MSADDR). Any free space between two allocated segments is consoli- 
dated and is represented by a single entry stored in the MST between 
entries for the two allocated segments. The last entry in the table 
is always followed by a zero word. To provide for the case where 
ewery allocated segment is surrounded by free segments, the MST must 
have twice as many words in it as the maximum number of allocated 
segments, plus two more. 








16 




-tO 




63 




TYPE 


SIZE 


ADDR 



Figure l.MS-1. Memory Segment Table (MST) entry 



Field 
MSTYPE 

MSSIZE 
MSADDR 



Word 








Bits 
0-15 

16-39 
40-63 



Description 

Contains if the segment is free; 
otherwise, it contains the JXT ordinal 
of the job to which the segment is 
allocated. 

Number of words in the segment. This 
is always a multiple of 1000 8 . 

STP-relative address of the first word 
in the segment. This is always a 
multiple of 1000 8 . 
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l.OD OPEN DATASET NAME TABLE - ODN 

A 2-word Open Dataset Name Table (ODN) is generated in the user field the 
first time an OPEN of the specified dataset is encountered. 





»t0 


56 63 





DN 


WM 


1 


'//////////////////////////////////////////A 


DSP 





Figure 1.0D-1. Open Dataset Name Table (ODN) 



Field 


Word 


Bits 


Description 


ODDN 





0-55 


Dataset name 


ODDSP 


1 


40-63 


DSP pointer 

negative - Negative DSP offset 
positive - Absolute address of DSP 
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l.PD PERMANENT DATASET TABLE - PDS 

The PDS in STP resident contains an entry for each active permanent 
dataset. A PDS entry indicates how a dataset is accessed and, if multiple 
access exists, how many users are accessing the dataset. 

The PDS is used to control the release of DAT entries for permanent 
datasets. 

Figure l.PD-1 illustrates the PDS. 
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63 
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Header 



Entry 



Figure l.PD-1. Permanent Dataset Table (PDS) 



HEADER 






Field 


Word 


Bits 


PDFULL 








PDPDE 





40-63 



Description 

PDS full indicator; i.e., datasets currently 
being accessed 

Number of permanent datasets currently 
being accessed; i.e., number of entries 
in table 



ENTRY 

Field 

PDUNQ 
PDUSR 

PDMRR 
PDUAR 

PDENT 



Word 










Bits Description 

Unique access flag 

1-8 Number of users currently accessing 
dataset 

9 Multiread access requested 

10 Unique access requested 

11 System directory flag 
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ENTRY, conti 


inued 




Field 


Word 


Bits 


PDDSC 





12-39 


PDDCP 





12-35 


PDDCE 





36-39 



Description 

Dataset Catalog pointer 
DSC page number 
DSC entry number 
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l.PI PERMANENT DATASET INFORMATION TABLE - PDI 

The PDI (figure l.PI-1) is a 1-word STP-resident table generated during 
system startup for use by the permanent dataset manager. 
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32 
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63 
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V/////A 


DNT 



Figure l.PI-1. Permanent Dataset Information Table (PDI) 

Field Word Bits Description 

Number of overflow pages 
Number of hash pages 
DNT for DSC 



PIOVP 





0-15 


PIHSP 





16-31 


PIDNT 





40-63 
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l.PM PERMANENT DATASET DEFINITION - PDD 



A PDD is a parameter list that accompanies a Permanent Dataset Management 
request and has one of four formats. 

FORMAT 1 of PDD 

The PDD illustrated in figure l.PM-1 is used for save, save input, save 
output, access, access spooled, load, load input, load output, and PDN 
requests. 

- S £-WAIT 16 24 32 1+0 h8 52 56 63 



5 
6 
7 

8 
9 

10 
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12 
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Figure l.PM-1. PDD Format 1 
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Field 



Word 



Bits 



PMSG 





PMERR 





PMWAIT 





PMNRLS 





PMLSD 





PMST 





PMFC 





PMDN 


1 


PMPDN 


2 




3 


PMPDN1 


2 


PMPDN2 


3 


PMID 


4 


PMUSR 


5 




6 


PMTXT 


7 


PMFM 


7 



PMRT 

PMED 

PMOJB 

PMSID 

PMDID 

PMDC 



PMJSQ 
PMTID 

2240012 



7 
7 
8 
9 
9 
9 



9 
10 








1 




2 




3 




15 


-39 


4C 


1-51 


52 


!-63 


0- 


55 


0- 


63 


0- 


55 


0- 


53 


0- 


63 


0- 


63 


0- 


■63 


0- 


•55 


0- 


•23 


24 


I--39 



40-51 

52-63 

0-55 

0-15 

16-31 

32-47 



48-63 
0-63 



Description 

Normal completion message suppression 
indicator 

Error message suppression indicator 

WAIT flag for a disposed dataset 

No release of dataset on DISPOSE 

Temporary SDT address for load 
input/output 

Return status 

Function code (table l.PM-1) 

Local dataset name 

Permanent dataset name; 1-15 char- 
acters 

Characters 

Characters 1-8 

Characters 9-15 

User identification 

User number; 1-15 characters 

Address of optional text field 

Format designator: 

FMCD=CD Character/deblocked 
FMCB=CB Character/blocked 
FMBD=BD Binary/ deblocked 
FMBB=BB Binary/blocked 

Retention period; 0-4095 days 

Edition number (0-4095) 

Originating job name 

Source ID; 2 characters 

Destination ID; 2 characters 

Disposition code; 2 characters 
DCIN=IN Job dataset 
DCST=ST Dataset to be staged 
DCSC=SC Scratch dataset 
DCPR=PR Print dataset 
DCPU=PU Punch dataset 
DCPT=PT Plot dataset 
DCMT=MT Magnetic tape dataset 

Job sequence number 

Terminal ID; 1-8 characters 
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Field 



Word 



Bits 



PMSF 


11 


0-63 


PMUQ 


12 





PMENT 


12 


1 


PMIR 


12 


2 


PMTXL 


12 


3-10 


PMNRR 


12 


11 



PMINIT 



PMDSZ 



PM0.1SQ 
PMCRT 



12 



25 



25 
26 



12 



PMIA 


12 


13 


PMDFR 


12 


14 


PMNA 


12 


15 


PMFL 


12 


16-31 


PMTL 


12 


32-55 


PMPR 


12 


56-63 


PMRD 


13 


0-63 


PMWT 


14 


0-63 


PMMN 


15 


0-63 


PMJCN 


16 


0-55 


PMCL 


17 


0-55 


PMSYS 


18 





PMJSP 


18 


1-8 


PMJCR 


18 


9-24 


PMOLM 


18 


25-48 


PMRJST 


18 


49-55 


PMACS 


25 


0-15 



U-47 



48-63 
0-63 



Description 
Special forms 

Unique access required 

Enter in System Directory 

Immediate reply requested 

Number of words of text 

Job rerun flag; set if job cannot be rerun 
(input entries only) 

Job initiate flag; set if job has been 
initiated 

Interactive flag 

Deferred disposition indicator 

No abort flag. If set, processing will 
continue even if an error is encountered. 

Field length/512 (input datasets only) 

Time limit (input datasets) 

Priority (input datasets) 

Read permission control word 

Write permission control word 

Maintenance permission control word 

Job class name 

CL parameter from JOB staement 

System job 

JOB statement priority 

Job class rank 

Size of $0UT in 512-word block 

Job status flag 

Number of accesses (load saved datasets 
only) 

Size of dataset as reflected by DSC DAT 
bodies (used only when a pseudo access is 
performed during the recovery of rolled 
jobs) 

Originating job sequence number 

Creation time in cycles (load request 
only) 
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PMACT 27 
PMTDM 28 
PMMOD 29 

FORMAT 2 of PDD 
The PDD illustrated 
requests (AUDIT and 



0-63 Time of last access in cycles (load 
request only) 

0-63 Time of last dump in cycles (load request 
only) 

0-63 Time of last modification in cycles (load 
request only) 



in figure l.PM-2 is used for LOADRQ (PDSLOAD), page 
PDSDUMP), and dump time requests (PDSDUMP). 




Field 



PMSG 



Word 



Figure l.PM-2. PDD Format 2 



Bits 







Description 

Normal completion message suppression 

indicator 

Error message suppression indicator 

Return status 

Function code (see table l.PM-1) 

Local dataset name 

Number of pages 

Beginning page number 

Buffer address 



The PDD illustrated in figure l.PM-3 is used for delete and release requests, 



PMERR 







1 


PMST 







40-51 


PMFC 







52-63 


PMDN 




1 


0-55 


PMNPG 




2 


32-47 


PMBPG 




2 


48-63 


PMBUF 




3 


40-63 


FORMAT 


3 of 


PDD 






56 



FC 



63 



Figure l.PM-3. PDD Format 3 
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Field 



Word 



Bits 



Description 



PMSG 



PMERR 









1 


PMST 









40-51 


PMFC 









52-63 


PMDN 






1 


0-55 


FORMAT 


4 


of 


PDD 





Normal completion message suppression 
indicator 

Error message suppression indicator 

Return status 

Function code (see table l.PM-1) 

Local dataset name 



The PDD illustrated in figure l.PM-4 is used for queue SDT and dequeue 
SDT processing. On a dequeue SDT request, the Permanent Dataset Manager 
returns to the requester the address of the SDT in the field PMSDT. 
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Figure l.PM-4. PDD Format 4 



Field 



PMSG 



Word 



Bits 



PMERR 





1 


PMST 





40-51 


PMFC 





52-63 


PMDN 


1 


0-55 


PMPDN 


2 


0-63 




3 


0-55 


PMSDT 


4 


24-47 


PMSQJ 


4 


48-63 



Significance 

Normal completion message suppression 
indicator 

Error message suppression indicator 

Return status 

Function code (see table l.PM-1) 

Local dataset name 

Permanent dataset name; 

1-15 characters 

SDT address 

Job sequence number 
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Table l.PM-1. Permanent dataset function codes 
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Symbol 


Octal 
Code 


Function 


PMFCSU 


10 


Save user dataset 


PMFCSI 


12 


Save input dataset 


PMFCSO 


14 


Save output dataset 


PMFCAU 


20 


Access user dataset 


PMFCAI 


26 


Access spooled dataset 


PMFCAO 


26 


Access spooled dataset 


PMFCDU 


30 


Delete user dataset 


PMFCDI 


36 


Delete spooled dataset 


PMFCDO 


36 


Deleter spooled dataset 


PMFCPG 


40 


Page request 


PMFCLU 


50 


Load user dataset 


PMFCLI 


52 


Load input dataset 


PMFCLO 


54 


Load output dataset 


PMFCRL 


60 


PDS/Release request 


PMFCPN 


70 


PDN request 


PMFCDT 


100 


Dump time request 


PMFCDQ 


110 


Dequeue SDT 


PMFCEA 


120 


Queue SDT to available 
queue 


PMFCEI 


122 


Queue SDT to input queue 


PMFCEO 


124 


Queue SDT to output queue 


PMFCAD 


130 


Adjust user dataset 


PMFCMD 


140 


Modify user dataset 


PMFCRSDT 


150 


Rewrite input SDT entry 


PMFCPSAC 


160 


Pseudo-access for RRJ 


PMFCPU 


170 


Access user saved dataset 
for PDSDUMP 


PMFCPO 


176 


Access output dataset for 
PDSDUMP 


PMPCPI 


176 


Access input dataset for 
PDSDUMP 


12 


Par 
l.P 


t 5 D 
M-6 



1 . PR PROCEDURE FILE STACK _TAB LE 

The Procedure File Stack Table is JTA-resident and serves as a stack 
for the nesting of control statement datasets. The F$PRC and F$RTN 
calls add entries to and delete them from this stack. 




1 




DNT 



DSP 



Table l.PR-1. Procedure File Stack Table 



Field 



Word 



Bits 



PRABT 





1 


PRRTN 





16-39 


PRLVL 





40-42 


PRDNT 


1-7 


16-39 


PR DSP 


1-7 


40-63 



Descriptio n 

RTN abort flag 

RTN return address 

Current stack level (0-7) 

$CS DNT address (STP relative) 

$CS JTA save area address (STP 

relative) 
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l.PT POOL TABLE ~ PT 

The Pool Table is an STP-resident table used for memory pool management. 
It is illustrated in figure l.PT-1. 



58 63 




Header 



Entries 



Figure l.PT-1. Pool Table 



HEADER 






Field 


Word 


Bits 


PTMAX 





58-63 


ENTRY 






Field 


Word 


Bits 


PTSIZE 





16-39 


PTBASE 





40-63 



Description 

Maximum valid memory pool number in system 



Description 

Size of the memory pool 

Base address of the memory pool 
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l.PU PHYSICAL UNIT TABLE - PUT 



This EXEC-resident table is used for working storage by the disk driver. 
There is one entry for each disk drive in the system. The PUT is 
illustrated in figure l.PU-1. 

4^RSV 38 43 46 58 63 



M,K 


\*W////////, 


W////////////////, ICH LU7 LCY 


YM 


1 


mw////////A 


m^^« CPD 


TPC 


AU 


2 


FCT 


3 


RSP 


4 


-OT,>MS^^ NCY 


NTK 


NSC 


5 


y///////////^^^^^^ ofv 


6 


EST ES 0FD 


7 


LIT LIC 


8 


RET 


REC 




Figure l.PU-1. 


Physical Unit Table (PUT) 


Fielc 


1 Word 


Bits 


Description 


PUAC1 








Disk active flag 


PUUP 





1 


Unit up 


PUERF 


\ 


2 


Error 


PURS\ 


I 


3 


Unit reserved 


PURM 





4 


Recovery mode 


PUICh 


\ 


38-42 


Input channel number 


PULU1 





43-45 


Last unit number 


PULC\ 





46-57 


Last cylinder 


PUCPC 


) 1 


40-51 


Cylinders per disk 


PUTPC 


; i 


52-57 


Tracks per cylinder 


PUAU 


i 


58-63 


Blocks per allocation unit (sectors 
per track) 


PUFC1 


2 


0-63 


Last function 


PURSF 


> 3 


0-63 


Last response 


PUNTC 


) 4 





Next transfer direction 


PUNC\ 


4 


40-51 


Next cylinder 


PUNT* 


: 4 


52-57 


Next track 
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Field 



Word 



Bits 



Description 



PUNSC 

PULS 

PUES 

PUOFD 

PUOFV 

PUEST 
PUERRE 
PUCEF 
PURWE 
PULSS 
PUFSS 

PULIT 

PULIC 
PURET 
PUREC 



4 
5 
5 
5 
5 
6 
6 
6 
6 
6 
6 

7 

7 
8 
8 



58-63 Next sector 

56 Last margin late strobe flag 

57 Last margin early strobe flag 

58 Last margin offset direction 
59-63 Last margin offset value 

0-63 Edited status 

1 Error flag 

2 Channel error flag encountered 

3 Read/write response error 
16-39 Subsystem status, last retry 
40-63 Subsystem status, first error 

0-58 Estimated latest time of last function 
completion for lost-interrupt detection 

59-63 Hardware input channel number 

0-39 Time of last retry 

40-63 Retry count 
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1 .QD QUEUE_D_DATASET_TABLE_ I _QDT 

The Queued Dataset Table is an STP-resident table that describes the 
mul titype attributes for a dataset that has been disposed. This table is 
managed by PDM and EXP. The number of entries in the QDT must be equal to 
the SDT entry count. 



Header: 



60 63 




Entry: 
SERR 



X 



HI 



USR 



ODC 



PDC 



Header: 



Figure l.QD-1. Queued dataset table (QDT) 



Field 



Word 



Bits 



QDNAM 





0-23 


Entry: 






Field 


Word 


Bits 


QDSERR 





0-3 


QDDWN 
QDCRS 
QDCAT 
QDIDA 









1 
2 
3 


QDUSR 





12-21 


QDODC 





22-30 


QDPDC 





36-63 


QDPDP 
QDPDE 






36-59 
60-63 



Description 

ASCII name of table, i.e., "QDT" 



Descriptio n 

STARTUP entry deactivation flags 

Down device encountered 
Cross allocation found 
Catastrophic error in DSC entry 
Inconsistent mul titype allocation 

Number of users who have disposed the 
dataset with no release 

Outstanding dispose count 

DSC entry of permanent version 

DSC page number 
DSC entry number 
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l.RJ ROLLED JOB INDEX - RJI 

The RJI table contains entries for each defined JXT entry describing the 
job assigned to the JXT entry and controlling the recovery of jobs from 
mass storage entries. 



Entry zero fields (used for index validation) 




Figure l.RJ-1. Rolled Job Index (RJI) entry zero fields 

Field Word Bits Description 

RJNJXT 0-15 Number of JXT entries in the last- 

Deadstarted system 

RJMSIZ 40-63 Memory size at last Deadstart 

RJ0LDV 1 0-63 Device name containing index for $R0LL 

dataset 

RJJ3AI 2 48-63 First (or only) AI in $R0LL index 

RJLJXT 3 0-6 Length of JXT entry in old system 

RJLDNT 3 7-12 Length of DNT entry in old system 

RJLRJI 3 13-18 Length of RJ index entry in old system 
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Other entry fields 



NRCV 








16 






32 


k8 




63 





DPH1 


1 






DPH2 






z 


DAI 


3^ 


V////ZW///, 


SID 


^^M^ 


JSQ 


4 


TID 


5 


JN 



Figure l.RJ-2. Rolled Job Index (RJI) other entry fields 



Field 

RJDPH1 

RJDPH2 

RJDAI 

RJNRCV 

RJSID 

RJJSQ 

RJTID 

RJJN 



Word 


1 
2 
3 
3 
3 
4 
5 



Bits Description 

0-63 Word of job roll DAT partition header 

0-63 Word 1 of job roll DAT partition header 

0-63 First AI word from roll DAT (1-4 AIs) 

Job irrecoverable flag 

16-31 Station ID of job origin 

48-63 Job sequence number 

0-63 Terminal ID of job origin 

0-63 Jobname 
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l.RQ REQUEST TABLE - RQT 

The Request Table is an STP-resident table primarily used for disk queue 
management. The RQT is illustrated in figure l.RQ-1. 





) 


16 ; 


>0 1h 


32 


+ 63 





TN '^m^MMM^M 


1 


FQL 


FQT 


FQH 


• 
• 
• 


• 
• 
• 

/TD 





'>_RER THR 


V//A UNT 


TID 


DNT 


1 


SC 


DA 


MA 


2 


NBK 


SBK 


BUF 


3 


TRW 


4 


W///////////S. 


BLK 


FLK 




• 
• 
• 



Header 



Entry 



Figure l.RQ-1. Request Table (RQT) 



HEADER 








Field 


Word 


Bits 


Description 


RQTN 
RQFQL 
RQFQT 
RQFQH 



1 

1 
1 


0-23 

0-15 

16-39 

40-63 


Table name; "RQT" in ASCII 
Free queue length 
Free queue tail 
Free queue head 


ENTRY 








Field 


Word 


Bits 


Description 


RQTD 

RQRER 

RQTHR 









1 

2-19 


Transfer direction 

Reread 

Streaming threshold 
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ENTRY, continued 



Field 


Word 


Bits 


Description 


RQUNT 





24-31 


Unit number 


RQTID 





32-39 


Requesting task ID 


RQDNT 





40-63 


DNT address 


RQSC 


1 


0-15 


Sector count 


RQDA 


1 


16-39 


Disk address 


ROMA 


1 


40-63 


Memory address 


RQNBK 


2 


0-15 


Block count 


RQSBK 


2 


16-39 


Starting block 


RQBUF 


2 


40-63 


Buffer address 


RQTRW 


3 


0-63 


Task reply word 


RORET 


3 


0-23 


Caller's return address 


RQRCL 


3 


24 


Recall reply flag 


RQJXT 


3 


25-39 


JXT offset for job-related requests 


RQBLK 


4 


16-39 


Backward link 


RQFLK 


4 


40-63 


Forward link 
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1 . S D SYSTEM DA TASET TABLE - SDT 

An SDT entry is created in System Task Processor (STP) resident memory for 

each dataset that is spooled to or from a front end system. 

For staged datasets that are submitted as jobs to the CRAY-1, the first 
control statement (the JOB statements) must be cracked to obtain job 
scheduling information. 



Entry: 

Field 
SDDN 
SDAIO 
SDOC 



SDP 



SDDC 



Word 


1 
1 



SDDAT 


1 


SDNBK 


2 


SDSBK 


2 


SDBUF 


2 


SDPDS 


3 


SDACS 


3 


SDRDA 


3 


SDWTA 


3 


SDMNA 


3 


SDSZ 


3 


SDQDT 


7 



Bits Description 

0-55 Dataset name 

Active I/O 

1-2 Open/close status (binary) 

1 In 

2 Out 

3 In/out 

3 Type of processing, used by Disk Queue 
Manager 

Read 

1 Wr i te 

16-31 Disposition code (2 characters) 

DCIN=IN Job dataset 

DCST=ST Dataset to be staged and made 

permanent 

DCSC=SC Scratch dataset 

DCPR=PR Print dataset 

DCPU=PU Punch dataset 

DCPT=PT Plot dataet 

DCMT=MT Magnetic tape dataset 

40-63 DAT address 

0-15 Number of blocks to be read or written 

16-39 Starting block number 

40-63 I/O buffer address 

Permanent dataset flag 
1-11 Dataset access flags 

1 Read access flag 

2 Write access flag 

3 Maintenance access flag 
40-63 Dataset size in 512-word blocks 
31-39 Multitype flag/QDT entry index 
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10 

11 

12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 

24 
25 

26 

27 

28 

29 

30 



TXT 



JXO 



SID 



.NRR- 



DNT 



PDN 



WAIT 



^H 



ftf\ 



15 



_ TRA 

~ TR 



ID 



r- 



USR 



ENT 
UQ 



USRN 



FM 



FL 



RT 



TXL 



ED 



TL 



PR 



TSB 



RD 



WT 



MN 



OJB 



DID 



OJSQ 



DLY 



JSQ 



TID 




Figure l.SD-1. SDT entry 
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Field 



Word 



Bits 



SDPDN 


10 


0-63 


SDPDN1 


10 


0-63 


SDPDN2 


11 


0-55 


SDWAIT 


11 


59 


SDTRA 


11 


60 


SDTR 


11 


61 


SDUQ 


11 


62 


SDENT 


11 


63 


SDID 


12 


0-63 


SDUSR 


13 


0-63 


SDUSRN 


14 


0-55 


SDTXL 


14 


56-63 


SDTXT 


15 


0-23 


SDFM 


15 


24-39 



SDRT 


15 


SDED 


15 


SDJXO 


16 


SDFL 


16 


SDTL 


16 


SDPR 


16 


SDTSB 


17 


SDRD 


18 


SDWT 


19 


SDMN 


20 


SDOJB 


21 


SDDLY 


21 


SDSIB 


?2 


SDDID 


22 


SDOJSQ 


22 


SDJSQ 


22 



40-51 

52-63 

0-15 

16-31 

32-55 

56-63 

0-63 

0-63 

0-63 

0-63 

0-55 

6-63 

0-15 

16-31 

32-47 

48-63 



Description 

1-15 character permanent dataset name 

Characters 1-8 of PDN 

Characters 9-15 of PDN 

WAIT flag for a disposed dataset 

Transfer request issued flag 

Transfer request flag 

Unique access flag 

Enter system directory flag 

User ID: 1-8 characters 

Characters 1-8 of user number 

Characters 9-15 of user number 

Test field length in blocks 

Location of text area 

Format designator: two characters 

FMCD=CD Character/deblocked 

FMCB=CB Character /blocked 

FMBD=BD Binary/deblocked 

FMBB=BB Binary/blocked 

Retention period (0-4095 days) 

Edition number (0-4095) 

JXT offset 

Field length/512 

Time limit 

Priority 

Time submitted 

Read permission control word 

Write permission control word 

Maintenance permission control word 

Originating job name 

Postpone delay count 

Source ID: two characters 

Destination ID: two characters 

Originating job sequence number 

Job sequence number 
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Field 


Word 


Bits 


SDTID 


23 


0-63 


SDSF 


24 


0-63 


SDNRR 


25 






SOINIT 



25 



SDOLM 


25 


10-33 


SDLST 


25 


34-57 


SDRJST 


25 


58-63 



SDJCN 


26 


0-55 


SDCL 


27 


0-55 


SDIA 


28 





SDOPP 


28 


1 


SDORPH 


28 


2 


SDSYS 


28 


3 


SDJSP 


28 


40-47 


SDJCR 


28 


48-63 


SDAUT 


29 


40-63 


SDLK 


30 





SDQF 


30 


1-6 


SDI 


30 


1 


SDO 


30 


2 


SDE 


30 


3 


SDQ 


30 


4 


SDR 


30 


5 


SDS 


30 


6 


SDQC 


30 


7-15 


SDBLP 


30 


16-39 


SDFLP 


30 


40-63 



Description 

Terminal ID: eight characters 

Special forms 

Job rerun flag: set if job cannot be 
rerun 

Job initiation flag: set if job has been 
initiated 

Size of $0UT in 512-word blocks 

Pointer to current LST address 

Status flag set by recovery of rolled job 

Never initiated 

1 Rerun by system recovery 

2 Job not recoverable or rerunnable 

3 Job statement error 

Job class name 

CL parameter from JOB statement 

Interactive job, if set 

Operator raised priority to 15, if set 

Orphan job, if set 

System job, if set 

P parameter from JOB statement 

Job class rank 

AUT pointer (used for interactive only) 

Lock flag 

Queue flags 

Input 

Output 

Execution 

Request 

Receiving 

Sending 
Queue count; used in queue head only 
Backward link pointer 
Forward link pointer 
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l.ST SYSTEM TASK TABLE - STT 

The System Task Table (STT) is an EXEC-resident table used by EXEC for 
scheduling and controlling tasks. The table has three parts: a header, 
a part containing a parameter area for each task, and a part containing 
the exchange packages for each task. The STT is illustrated in figure 
l.ST-1. 



HEADER 

Field 

STTN 

STRTS 

STAID 

STAPB 

STDEF 

STAXP 

STBPF 



Word 

1 
1 
1 
2 
2 
4 



ENTRY (PART A) 
Field Word 



STSUS 







Bits Description 

0-23 Table name; "STT" in ASCII 

Request task scheduler flag 

44-51 Active task ID 

52-63 Active task parameter block address 

0-29 Defined task flags 

52-63 Active exchange package address 

0-63 Breakpoint flags 

Bits Description 

Task suspend bit 



STRDY 





7 


STPRI 





8-15 


STID 





16-23 


STCNT 





24-63 


STBO 


1 


40-63 


STTIME 


2 


0-63 


STNEC 


3 


0-63 


STRTQ 


4 


0-63 



Task ready request 

Task priority 

Task ID 

Task startup count 

B0 save area 

Cumulative execution time 

Count of normal exits from task 

Task time delay queue control word 
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7 8 12 16 



24 30 36 40 44 52 



I 




Header 



Entry 
(Part A) 



Entry 
' (Part B) 



Figure l.ST-1. System Task Table (STT) 
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STUJXO 


5 


STUJTA 


5 


STUTS 


5 


STUXP 


5 


STLPMC 


6 



ENTRY (PART B) 



Field Word Bits De scription 

0-12 User job execution table offset 

13-36 User job table area 

37-51 User time slice 

52-63 User XP address within EXEC 

0-63 Last performance monitor call 

Field Word Bits Description 

STPC 18-39 Program counter 

STA0 40-63 A0 

STBA 1 18-35 Base address 

STA1 1 40-63 Al 

STLA 2 18-35 Limit address 

STMDE 2 37-39 Mode flags 

STA2 2 40-63 A2 

STXA 3 16-23 Exchange address 

STVL 3 24-30 Vector length 

STFLG 3 31-39 Interrupt flags 

STA3 3 40-63 A3 

STA4 4 40-63 A4 

STA5 5 40-63 A5 

STA6 6 40-63 A6 

STA7 7 40-63 A7 

STS0 8 0-63 S0 

STS1 9 0-63 SI 

STS2 10 0-63 S2 

STS3 11 0-63 S3 

STS4 12 0-63 S4 

STS5 13 0-63 S5 

STS6 14 0-63 S6 

STS7 15 0-63 S7 
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l.TB TASK BREAKPOINT TABLE - TBPT 

The TBPT table is an EXEC-resident table used by EXEC for interactive 

debugging using breakpoints. 

Figure l.TB-1 illustrates the TBPT. 



p 




16 


24 1+0 




63 


NM 


W/////////A 
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• 
• 
• 
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ADR2 I 


ADR1 




; 






• 
• 
• 







Header 



} Entry 



Figure l.TB-1. Task Breakpoint Table - TBPT 



HEADER 






Field 


Word 


Bits 


TBNM 





0-23 


TBSCXP 





40-63 


TBIDLE 


1 


0-63 


ENTRY 






Field 


Word 


Bits 


TBINST 





0-15 


TBADR2 





16-39 



TBADR1 



40-63 



Description 

Table name; "TBP" in ASCII 

Station control word address 

Idle flag; invokes alternate part of 
task scheduler. 



Description 

Instruction replaced by breakpoint 

Address of breakpoint used to reset 
first breakpoint 

Address of breakpoint 
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LOADER TABLE DESCRIPTIONS 



2.1 INTRODUCTION 

A relocatable binary program consists of a single record composed of a 

series of tables. Nine types of tables are currently defined: 

Acronym Table type (octal) Name 

BRT 15 Block relocation table 

DIR 10 Directory (BUILD) 

DMT 7 Debug map table 

DPT 13 Duplication table 

PDT 17 Program description table 

SMT 11 Symbol table 

TXT 16 Text table 

XRT 14 External relocation table 

12 Reserved for user 

The first table in a relocatable module is the program description table 
(PDT). The relocatable code, itself, is contained in one or more text 
(TXT) tables. 

Each table has a prefix word that contains the table type in the leftmost 
four bits and the table word count in the next 24 bits. The word count 
serves as an offset to the beginning of the next table. 
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2.BRT BLOCK RELOCATION TABLE - BRT 



WC-1 




Figure 2. BRT. Block Relocation Table - BRT 



Field 
TT 

WC 
BI 



BI 



'1,2. ..n 



QWA 



Word 






1,2, 



1,2. ,.n ...WC-1 



1,2. ..n 



1,2, 

..WC-1 



1,2, 
..WC-1 



Bits 

0-3 

4-27 

32-38 



0-6, 
32-38 



7,39 



8-31. 
40-63 



Description 

Table type; 15 

Table word count 

A relocation quantity to be added to the 
QWAs to obtain the addresses of the fields 
to be modified. 

Block index; specifies a block base address 
to be added to the relocation field as the 
relocation address. 

Relocation mode: 

Word address relocation is performed 



on 



relocation field. 



1 Quarter word address relocation is 
performed. 

Word address relocation is generally used 
to relocate the address in memory read and 
store instructions. Quarter word address 
relocation is generally used to relocate 
addresses in branch instructions. 

Quarter word address; indicates the parcel 
address of a field relative to the block BI 
to be modified. 

QWA is composed of a 22-bit word address and 
a 2-bit field specifying the parcel. Parcels 
are located within words as follows: 
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N-l 

N 


1 


N 


2 


N 


3 


N 



The rightmost bits of the parcel indicate 
the rightmost bits of the field to be 
relocated. The relocation is 22 bits 
wide. Relocation across a word boundary 
occurs if parcel is specified. 
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2.DIR DIRECTORY - DIR (BUILD) 

BUILD is an operating system utility program for generating and maintaining 
library datasets. BUILD generates a directory file consisting of a one 
word header followed by one variable-length entry for each program in the 
library dataset. A program record's entry may have any length from 3 to 
66048 words. 



I 



Q 4 



16 



25 31 



kO 



55 



63 



2 



5TATJ 



TT 



DWC 



EWC 



XL, 



ID 



EL, 



FN, 



LMi 



FWC, 



FWA, 



0-511 block names 



0-32767 entry names 



TYPE. 



0-32767 external names 



EWC, 



5TAT!^LM 2 



XL? 



FN 2 



FWC 2 



0-511 block names 



0-32767 entry names 



0-32767 external names 



EL, 



FWA-, 



BL, 



Header 



BL, 



Entry 1 



Entry 2 
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I 



TYPE 



WC 



STAT! 



- fe LM r 



EWCn I XLn 

[Nn 



FWCn 



0-51 1 block names 



O-32767 entry names 



0-32767 external names 



ELn 



FWAp 



-BL*. 



■ Entry n 



Field 

TT 

DWC 

ID 



TYPE 

EWC 

XL 

EL 

BL 

FN 

STAT 

LM 

FWC 

FWA 



Word 







2 
3 
3 
3 



Bits Description 

0-3 Table type: 10 8 

16-39 Directory's word count 

40-63 'D01' in ASCII. The 01 indicates the 

BUILD revision level, thus specifying the 
directory format. 

0-3 Entry type: 1 

4-24 Entry's word count, 66048 maximum 

25-39 Number of external names, 32767 maximum 

40-54 Number of entry names, 32767 maximum 

55-63 Number of block names, 511 maximum 

0-63 8-character name of program module 

0-3 Entry status: 1 

4 Load module flag (LDR set and used) 

4-30 Program module's maximum word count, 
134 x 10 6 (an approximate value for 
information only) 

31-63 Program module's location, 17 x 10 9 
maximum 



Any of the three sets of names (block, entry, or external) may be null. 
Each name is 1 to 8 ASCII characters, left justified with zero fill. No 
blank characters are used. 
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Block names represent FORTRAN references to BLOCK DATA subprograms and 
labeled common. 

Entry names correspond to names of main programs and subroutines and to 
names of any labeled common blocks that are initialized by DATA statements. 

External names represent references to entry names in other programs. 
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2. DMT DEBUG MAP TABLE - DMT 




1 
2 
3 
4 



WC-2 
WC-1 



U h 




OVF 



•CBFi 



,CBF„ 



7777/ 



ONAM 



BNAMi 



BNAM, 




2 



BLEN! 



BLEN r 



Figure 2.DMT-1. Debug map table - DMT 



Field 






Word 




Bits 


Description 


TT 













0-3 


Table type; 7 


WC 













4-27 


Table word count 


OVF 






1 









Overlay flag; set if overlays exist 


ONAM 






2 






0-63 


Overlay name in ASCII 


CBF 


3 


,5 


,7. 


.WC- 


■2 





Common block flag 


BNAM 


3 


,5 


J. 


,WC- 


-2 


1-63 


Block name in ASCII 


BLEN 


4 


,6 


,8. 


.WC- 


-1 


40-63 


Length of block in words 



I 
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2. DPT DUPLICATION TABLE - DPT 



WC-1 



o 4 



28 32 



40 



63 



wr " wc mmmxzmmm 


\ INCi 


NDUPi 


Blj C 


) SWA, 


1 

! 
i 
| 




i 


i ! 



i 








j 

INC 

1 n ■ > 


NDUP 


Bl ( 

I — ^_n — L 


] SWA 

J -n 



Figure 2. DPT. Duplication Table - DPT 



Field 

TT 
WC 
INC 



1,2. 



NDUP 



1,2. ..n 



BI 



1,2. ..n 



SWA 



1,2. ..n 



Word 





1,2,.. 
WC-1 

1,2,.. 
WC-1 

1,2,.. 
WC-1 

1,2,.. 
WC-1 



Bits Description 

0-3 Table type; 13 

4-27 Table word count 

0-7 Increment between stores of the source 
word. No duplication occurs if a zero 
increment is specified. 

8-31 Number of times the word at SWA is dup- 
licated. NDUP must be nonzero. 

32-38 Block index; specifies the block whose 

base address is added to SWA in obtaining 
the word to be duplicated. 

40-63 Source word address; the address of the 
word that is duplicated. Duplication 
is performed before relocation or 
external linkage in the load process. 
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2.PDT PROGRAM DESCRIPTION TABLE - PPT 





2 4 


16 




28 35 40 


42 




^fi fi3 





T7 P 


wc 




XL 




EL 


BL 


1 


%m 


PGMN 










2 


ORG 




PRGL 




3 


^FE 




BLKN 1 ^BLKD X 






4 


y^C^ryy^/L 


Slii^W 


BLKL X 


5 















I 1 Blocks 



BL-1 

BL 

BL+1 

BL+2 

BL+3 



BLKN 



]^ KJ n- 



'Zl. 



BLKL 



ENTNi 



PE 



Bl 



Q 



ENTV 



1 



' 






1 
1 


BL+EL-2 


ENTN P c 


BL+EL-1 


mmmmm<mmmzm<A "'. 


K 


BL+EL 


ENTVm 


BL+EL+1 


EXTN X 


• 









■. Entry 
names 



1 



■ External 
names 



BL+EL+XL 
BL+EL+XL+1 



EXTN 



HDRi 



WC-1 



HDRq 



Header 
words 



Figure 2.PDT-1. Program Description Table - PDT 
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Field 



Word 



Bits 



TT 





0-3 


WC 





4-27 


XL 





28-41 


EL 





42-55 


BL 





57-63 


PGMN 


1 


0-63 


AF 


2 






FE 



ORG 


2 


16-39 


PRGL 


2 


40-63 


BLKN, 

1,2. . .n 

BLKD, 

1,2. . .n 


3,5,7... 
4,6,8... 


0-63 
35 


BLKL, 

1,2. . .n 

EN ™i m 
1 ,2. . .m 


4,6,8... 

BL+1,+4, 
+7... 


40-63 
0-63 


PE 1 9 m 

1 ,2. . .m 


BL+2,+5, 
+8... 


55 


BI, 
1,2. . .m 


BL+2,+5, 
+8... 


56-62 



Descri ption 

Table type; 17 

Table word count 

Word count for external names 

Word count for entry names 

Word count for block information 

Program name 

Absolute flag; set to 1 if code has no 
BRT or XRT tables. 

Fatal error flag; set to 1 if fatal 
compile/assembly errors occurred. The 
loader ignores the binary record. 

Origin of absolute blocks 

Program length in words 

Block name 

Reserved for dynamic common block indica- 
tor; not used by COS loader. 

Length in words of named common block 

Entry name 

Primary entry flag. If this bit is set, 
this entry is the primary entry of the 
current load. The Loader transfers control 
to the first encountered primary entry. 

Block index; specifies the block contain- 
the named entry. Associated with the block 
is a block address used to modify the entry 
value when it is used to satisfy externals 
of the same name. 

The 7-bit BI field used in all table 
entries defines a relocation quantity as 
f ol 1 ows : 

None 

1 Negative to the program block 

2 Positive to the program block 

3 Positive to common block 1 



4,2. ..m 
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127 Positive to common block 125 

BL+2,+5, 63 The Q field determines the relocation 
+8... mode of the entry value. If the bit is 

set, the entry value is a parcel address 
and the block address is justified before 
relocation. If clear, relocation is 
performed with a word address. Note that 
if BI=0, the entry value is not modified. 
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Field 



Word 



Bits 



ENTV, 9 m BL+3,+6, 0-63 

1 ,C . . •"Lf.g 



EXTN, n BL+EL+1, 0-63 
l,^...p +2> _ 



HDR, 9 n BL+EL+XL+1 0-63 
i,^...q through WC-1 



Description 

Entry value. This is a 64-bit quantity 
associated with the entry name. For 
satisfying externals, an entry relocation 

quantity is determined by adding a BI 
block address to the entry value. 

External name. A name is t through 8 
characters, left justified with zero fill 
The string must not include the space 
character. Blank common is indicated 
in the tables either by a zero word or 
by the name //. 

PDT header data. See figure 2.PDT-2. 






M 


M 


/ 


D 


D 


/ 


Y 


Y 


1 


H 


H 


: 


M 


M 


: 


S 


s 




C 





S 


A 


1 


. 


N 


N 




M 


M 


/ 


D 


D 


/ 


Y 


Y 


4 


A 


A 


A 


A 


A 


A 


A 


A 


5 


c 


A 


L 


A 


1 


• 








6 


7 


6 


2 


1 


6 


A 


A 


A 


7 





. . 












.0 


8 





, . . 












.0 


9 

















.0 


10 















. . 


.0 


11 


C 





P 


Y 


R 


I 


G 


H 


. 


T 


A 


C 


R 


A 


Y 


A 


R 


* 


E 


s 


E 


A 


R 


C 


H 


A 


20 


I 


N 


C 


. 


1 


9 


7 


6 



Date and time of compilation 

COS revision level 
COS assembly date 

Processor name and version 
Processor level (Julian date or 
modification level) 

Reserved for future use - hardware 
dependencies, etc. 

0-80 characters of user comment left 
justified, blank filled 



Figure 2.PDT-2. PDT header data 
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2.SMT SYMBOL TABLE ~ SMT 

A relocatable file may contain symbol table information for each program unit 
in a compilation. The information is in table type 11. A type 11 table 
consists of two parts: a subroutine table and one or more common block 
tables. 

Subroutine table 

The subroutine table contains information about the subroutine block, the 
common block(s) referenced by the subroutine, and the local symbols. 
Figure 2.SMT-1 illustrates the basic format of the subroutine table; 
for more detail, refer to the figures named in figure 2.SMT-1. 



CML 



CML+SYL 



WC-1 



header 
(figure 3) 



symbol 

descriptors 

(figures k and 5) 



dimension 
descriptors 
(figure 6) 



auxil iary data 



Figure 2.SMT-1. Subroutine table 
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Common block table 

The common block table contains information about a specific common block 
referenced within a subroutine and the symbols that the common block 
contains. In a symbol table there is one common block table for each 
common block named in the subroutine table. The final word of the common 
block table, field THC, gives the common block table checksum. Figure 
2.SMT-2 illustrates the basic format of the common block table. 



CML 



CML+SYL 



WC-1 



header 
(figure 7) 



symbol 
descriptors 
(figures k and 5) 



d imension 
descriptors 
(figure 6) 



auxi 1 iary data 



table checksum 



Figure 2.SMT-2. Common block table 
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DBF- 



c 


k 10 


16 


4 


18 


32 39 


VI 6c 





11 


wc 


'////, 


BI 


CML 


'//////////////////. 


T* 




SYL 


DIL 


PL 


PEA 


2 


SN J 


3 


CNAMi 



CML-1 



CNAM n 



Figure 2.SMT-3. Subroutine table header 



Field 

TT 
WC 
BI 



Word 







Bits 

0-3 

4-27 

32-38 



CML 





39-46 


DBF 


1 





SYL 


1 


1-16 


DIL 


1 


17-31 


PL 


1 


32-39 


PEA 


1 


40-63 


SN 


2 


0-63 


CNAM!- 
CNAM n 


O ) • • • s 

CML-1 


0-63 



Description 

Table type; 11 

Table word count 

Block index. This is an index into the 
subroutine table common block name list 
(the same list as contained in the PDT 
table). 

Length in words of named common block 

Dynamic block flag 

Static 

1 Dynamic 

Symbol block length 

Dimension block length 

Prologue length (parcel) 

Primary entry address (parcel ) 

Subroutine name 

Name(s) of common block (s) referenced 
by the named subroutine 
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Symbol descriptors 

Words CML through CML+SYL+1 contain descriptors of local symbols. Each 
descriptor (figure 2.SMT-4) may be 3 through 6 words long, depending on 
the symbol length. In addition, a dimensioned variable symbol points to 
a group of words in the dimension block for its dimension information. 



SI 
S2 



2 

5 



AM 



ST 



DA f/E 
CL 



PSI 



ASM 

30 j3t 

ND 



k<3 



63 



DBI 



EL 



Symbol class-dependent information (see figure 2.SMT-5) 



SNAM 



Figure 2.SMT-4. Symbol descriptor format 



Field 

SL 

ST 



Word 

SI 
SI 



Bits 

0-1 
2-6 



Description 

Symbol name length-1 in words 
Symbol type 

Unknown 

1 Program (external) 

2 Entry point 

3 Label 

4 Integer 

5 Real 

6 Compl ex 

7 Logical 

8 Character 

9 Bit (Boolean) 

10 File 

11 Pointer 

12 DP integer 

13 DP real 

14 DP complex 

15 Structure 

16 Address 
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Field 


Word 


Bits 


Description 


CL 


SI 


7-10 


Symbol class 

Constant 

1 Register 

2 Normal 

3 Stack 

4 Based pointer 

5 Based descriptor 


DA 


SI 


11 


Dummy argument (parame 
zero, the symbol is a 


AM 


SI 


12 


Argument mode 

Address 

1 Value 



If non- 



EQ SI 13 Equivalence. If non-zero, the symbol 

is equivalenced. 

PSI si 14-29 Parent symbol index. If non-zero, 

the index is within SYL of the top 
parent. 

ND SI 30-32 Number of dimensions 

ASM SI 33 Array storage mode 

By column 

1 By row 

DBI Si 34-48 Dimension block index 

EL SI 49-63 Element length (in bits) 

S2 0-63 Symbol class-dependent information; see 

figure 2.SMT-5. 

Class Figure 

2.SMT-5a 

1 2.SMT-5b 
2-5 2.SMT-5C 

SNAM S3-S6 0-63 Symbol name. 1-4 words (32 character 

maximum) in 8-bit ASCII, left- justified: 
null filled to end-of-word. 
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Symbol class-dependent information 

The contents of word S2 of the symbol descriptor are determined by the 
class of the symbol. Class type may be found in field CL of the 
subroutine table, word CML, bits 7-10. Classes are as follows: 

Constant value 

1 Register 

2 Normal 

3 Stack 

4 Based pointer 

5 Based descriptor 

Figure 2.SMT-5a, b, and c describe the formats that word 2 of the symbol 
descriptor can take, based on the symbol class. 



SVAL 



63 



Figure 2.SMT-5a. Word CML+1 for class symbols 



Field 
SVAL 



Word 
CML+1 



Bits 
0-63 



Description 

The value of the symbol 



3M- 38 



RT 



RN 



63 



Figure 2.SMT-5b. Word CML+1 for class 1 symbols 



Field 



RT 



Word 



CML+1 



Bits 



34-37 



Description 




Register type 

1 A 

2 B 

3 S 


4 T 

5 V 

6 Special 
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Field 



RN 



Word 
CML+1 



Bits 



38-47 



Description 

Register number or subtype. For register 
types 1 through 5, RN contains a register 
register number. For register type 6, 
RN contains one of the following values, 
right justified with zero fill : 

Vector length register 

1 Vector mask register 
2-31 Channel address register 
32 P register 



10 



BI 



SSL 



34 



63 



BO 



Figure 2.SMT-5c. Word CML+1 for class 2-5 symbols 



Field 

BI 
SSL 

BO 



Word 

CML+1 
CML+1 

CML+1 



Bits 

3-9 
10-33 

34-63 



Description 

Block index 

Symbol storage length; words occupied 
in storage 

Bit offset-, offset in bits from the 
block base or from the parent symbol 
base 



Dimensi on descriptors 

The dimension descriptor portion of the subroutine or common block table 
contains a dimension descriptor for each dimensioned variable symbol (ND#3). 
Each descriptor consists of an n-word entry, where n is the dimension of the 
variable. Figure 2.SMT-6 illustrates a dimension descriptor entry. 



I 
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LDE n ' M.DI n 



UDEi UDIi 

36\38/i40 



fa 



ft 



I i 

i > 



rr 



63 



UDi 



UD r 



UDE n ' lUDI n 
Figure 2.SMT-6. Dimension descriptor entry format 



Field 



LDE 



LDI 



Word 



D0.D1. 



,Dn 



Bits 



10 



D0,Dl,...,Dn 



11 



LD 



D0,Dl,...,Dn 12-35 



Description 



Lower dimension expression. If LDE is 
non-zero, the lower dimension field 
(LD) contains an index into the dimen- 
sion block of the expression definition 
required to evaluate the lower dimen- 
sion. (See description of LD field.) 

Lower dimension indirect. If LDI is 
non-zero, the lower dimension contains 
an index into a symbol list of the 
symbol that contains the lower dimension 
value. (See description of LD field.) 

Lower dimension. The contents of LD 
depend on the values of LDE and LDI. 

If LDE=0 and LDI=0 then LD is the lower 
dimension value. 

If LDE/0+, then LD consists of the fol- 
lowing subfields : 



12 



20 



ACCL 



DIMI 



35 



ACCL The length in half words of 
the access function 

DIMI Index into DIL of the dimension 
expression 



+ NOTE: Cray Research software does not support LDE^O or UDE/0 
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Field 



Word 



Bits 



Description 



If LDI^O 1 ", then LD consists of the fol- 
lowing subfields : 



12 B 



35 



UDE D0,Dl,...,Dn 38 



UDI D0,Dl,...,Dn 39 



UD 



D0,Dl,...,Dn 40-63 



'i BI 


DSI 



BI Block index 

DSI Dimension symbol index 

Upper dimension expression. (Same as 
LDE, for upper dimension.) 

Upper dimension indirect. (Same as 
LDI, for upper dimension.) 

Upper dimension. The contents of UD 
depend on the values of UDE and UDI. 
The alternative formats for UD are the 
same as for LD. 



DBF' 



11 



16 



we 



SYL 



DIL 



2B 32 



39 



m 



BI 



CML 



wm 



W////////////A 



BS 



CNAM 



Figure 2.SMT-7. Common block table header format 



Field 


Word 


Bits 


Description 


TT 





0-3 


Table type; 11 


WC 





4-27 


Word count 


BI 





32-38 


Block index 


CML 





39-46 


Common block length 


DBF 


1 





Dynamic block flag 

Static 

1 Dynamic 


SYL 


1 


1-16 


Symbol block length 


DIL 


1 


17-31 


Dimension block length 


BS 


1 


40-63 


Block size 


CNAM 


2 


0-63 


Name of common block 



+ NOTE: Cray Research software does not support LDI^O or UDI^O 
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2. TXT TEXT TABLE - TXT 

h 





1 

2 

■ i 



16 



WC-1 



WC 



28 32 



40 



63 



Bl 



i 



LA 



TXTW, 



TXTW" 



Figure 2. TXT. Text Table - TXT 



Field 
TT 

WC 
BI 

Q 

LA 

TXTW 



Word 






1,2. 



Bits 

0-3 

4-27 

32-38 

39 

40-63 



1,2. ..n 0-63 



Description 

Table type; 16 

Table word count 

Block index; specifies the block into 
which the text will be loaded. 

Relocation mode of the entry name; this 
field is always 0. 

Relative load address in block BI. LA 
is always specified as a word address. 

Text words to be loaded into the program 
field in contiguous locations starting at 
an address determined by adding LA to the 
base address indicated for block BI. 
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2.XRT EXTERNAL RELOCATION TABLE - XRT 



WC-1 







XI 



XI, 



28 3k 
1^ 



63 



BA, 



BA. 



Figure 2. XRT External Relocation Table - XRT 



Bits 
0-3 
4-27 
6-12 



Ql,2...n 1 ' 2 -" n 13 



Field 


Word 


TT 





WC 





BI, o „ 


1,2 



XI n 9 n 1,2. ..n 14-27 



L, ? l,2...n 28-33 

J. J C * ■ a 



BA l,2...n 1 ' 2 - n 34 " 63 



Description 

Table type; 14 

Table word count 

Block index; defines a block address to 
be added to a BA in obtaining the field 
to be relocated (linked). 

Q flag; indicates attribute of the field 
to be linked. Q is set if the field 
requires a parcel address. Q is if 
a word address is desired. The loader 
adjusts the entry values in links where 
the respective Q flags do not match. 

External index. This is an index into 
the externals list of the PDT. The 
entry value corresponding to the entry 
name that matches the named external in 
the PDT table is used to relocate the field. 

Length in bits of the relocation field. If 
L=0, the relocation field is assumed to be 
64 bits, otherwise, it is the length speci- 
fied by L. 

Bit address of the low order bit in the 
field to be relocated. 

Relocation is performed in 2's complement 
arithmetic and relocation will span at most 
only one word boundary. 
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